home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / comm / mail / AEMail230.lha / aemail230 / documentation / AEMail.doc next >
Text File  |  2000-03-11  |  483KB  |  10,666 lines
  1.  
  2.                                 AEMAIL.DOC
  3.  
  4.  
  5. Name of Program: AEMail (Amiga E-Mail)
  6.  
  7. Version: 2.30
  8. Release Date: March 31, 2000
  9.  
  10. Written By: John F. Zacharias
  11.  
  12. AEMail is copyright (c) 1996-2000 by John F.  Zacharias, all rights
  13. reserved.  Permission is given to unregistered users to test and evaluate
  14. the program in return for feedback on the use of the program and reporting
  15. of any bugs encountered.
  16.  
  17.      AEMAIL SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE;
  18.      NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  19.      OR RESPONSIBILITY IS ASSUMED.
  20.  
  21. Installer and Installer project icon (c) Copyright 1995-96 Escom AG.  All
  22. Rights Reserved.  Reproduced and distributed under license from Escom AG.
  23.  
  24. INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE;
  25. NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  26. OR RESPONSIBILITY IS ASSUMED.
  27.  
  28. ClassAct Copyright (c) 1995,1996 Christopher E.  Aldi.  All Rights
  29. Reserved.
  30.  
  31. This documentation is divided into the following Sections and sub-topics:
  32.  
  33.     I. PROGRAM PURPOSE
  34.  
  35.     II. SYSTEM REQUIREMENTS
  36.  
  37.         REQUIREMENTS
  38.         RESTRICTIONS
  39.         REGISTRATION
  40.         NOTIFICATION REQUESTER
  41.  
  42.     III. INSTALLATION
  43.  
  44.         CONFIGURING USERS
  45.         OTHER CONSIDERATIONS
  46.         SETTING THE TIME ZONE FOR AEMAIL
  47.  
  48.     IV. CONFIGURATION
  49.  
  50.         TOOL TYPES
  51.             INTERLACE=YES
  52.             MAIL_DIR=directory-path
  53.             CONFIG=configuration-file
  54.             USERID=UserId
  55.             PASSWRD=your_password
  56.             PASSPROTECT=YES             (registered users only)
  57.             DOMAIN=Domain_Name
  58.             FROM=your_email_address
  59.             REALNAME=your_real_name
  60.             REPLYTO=reply-email-address
  61.             ORGANIZATION=organization-name
  62.             POP_SERVER=your_POP_host
  63.             SMTP_SERVER=your_SMTP_host
  64.             EDITOR=call_line_for_your_editor
  65.             TCPLOG=name_of_log_file
  66.             DELETEMAIL=YES
  67.             FULLHEADER=YES
  68.             STRIPDUPS=YES
  69.             HDRINREPLY=YES
  70.             STARTNET=call_line_for_your_startnet_script
  71.             STOPNET=call_line_for_your_stopnet_script
  72.             AUTOCONNECT=YES
  73.             FLDRFONT=fontname
  74.             FLDRFONTSZ=fontsize
  75.             AREXXPORT=portname
  76.             HELP=full-path-name-to-"AEMail.guide"-file
  77.  
  78.         CONFIGURATION SETUP WINDOW
  79.             Identity Page
  80.             TCP/IP Page
  81.             Paths Page
  82.             Viewer Page
  83.             ARexx Page
  84.             Fonts Page
  85.             General Page
  86.  
  87.     V. USING AEMAIL
  88.  
  89.         Starting AEMail
  90.             Starting AEMail from the Shell
  91.             Activating AEMail from the Workbench
  92.         Getting Help with AEMail
  93.         Using AEMail as a "MailTo" Agent
  94.         Using Keyboard Hot Keys
  95.         Editing String Entry Gadgets
  96.         Using the Clipboard with AEMail
  97.         Using Web and Email addresses embedded in messages
  98.         Filtering Messages with AEMail
  99.  
  100.     VI. COMMAND ICON TOOL BAR
  101.  
  102.         Display Folder List
  103.         Display Address Book
  104.         Retrieve Messages
  105.         Display Previous Message
  106.         Display Previous Folder's Message List
  107.         Display Current Folder's Message List
  108.         Display Next Folder's Message List
  109.         Display Next Message
  110.         Compose A Message
  111.         Queue Message For Later Delivery
  112.         Send Message Immediately
  113.         Save Message To File
  114.         Print
  115.         Delete/Undelete Message
  116.         Copy Messages to a New Folder
  117.         Transfer Messages to a New Folder
  118.         Start TCP/IP Network Connection
  119.         Terminate TCP/IP Network Connection
  120.  
  121.     VII. AEMAIL MENUS
  122.  
  123.         Project menu
  124.             Configuration...
  125.                 Open...
  126.                 Edit...
  127.                 Save
  128.                 Save As...
  129.                 Restore Default
  130.             Send Queued Mail
  131.             Iconify AEMail
  132.             Send Notification...
  133.             Getting Help
  134.             About...
  135.             Quit...
  136.  
  137.         Folders menu
  138.             New...
  139.             Edit...
  140.             Delete
  141.             Move...
  142.             Set Sort Key...
  143.             Folder List
  144.                 Display
  145.                 Backup
  146.                 Restore
  147.             Remove DELETED Msgs
  148.  
  149.         Messages menu
  150.             Show
  151.                 Deleted Messages
  152.                 UnRead Msgs Only
  153.             Compose...
  154.             Reply
  155.                 Use Reply-To...
  156.                 Use From...
  157.             Forward...
  158.             Edit...
  159.             Select None
  160.             Select All
  161.             Last Selected
  162.             Export...
  163.             Copy...
  164.             Transfer...
  165.             Print
  166.             Delete/Undelete...
  167.             Lock/Unlock
  168.             Display Full Hdr
  169.             Fwd Body Txt Only
  170.             Incl Hdr in Resp
  171.  
  172.         Retrieve Msgs menu
  173.             From POP Host
  174.             From Local File...
  175.             Excl Dup Msgs
  176.             Delete Host Mail
  177.  
  178.         TCP/IP menu
  179.  
  180.             Start Net
  181.             Stop Net
  182.             TCP Logging File
  183.                 Active
  184.                 Purge
  185.                 Display/Edit...
  186.  
  187.         ARexx/DOS menu
  188.  
  189.             Send AREXX/DOS Command...
  190.             Send Last Command
  191.  
  192.             Commands Specified by ARexx Configuration Page
  193.             . . .
  194.             . . .
  195.  
  196.     VIII. AEMAIL WINDOWS
  197.  
  198.         Configuration Setup Window
  199.         Folder List Window
  200.         Message List Window
  201.         Folder Configuration Window
  202.         Filter Selection Window
  203.             Examples of using Message Filtering
  204.         Set Sort Keys Window
  205.             Examples of Setting Sort Keys
  206.         Address Book Window
  207.         Message Display Window
  208.             Attachment Requester
  209.         Compose Message Window
  210.             Add Attachments Requester
  211.  
  212.     IX. AEMAIL AREXX INTERFACE
  213.  
  214.         Introduction
  215.         Synopsis of ARexx Commands
  216.         ARexx Commands
  217.         Error Messages
  218.  
  219.     X. AEMAIL FILES
  220.  
  221.         mailcap
  222.         configuration (s:aemail.cnfg)
  223.         folder.config
  224.         [folder_Name].config
  225.         .addrbook
  226.         .signature
  227.         Messages
  228.         TCP Trace Log File (TCPLOG)
  229.  
  230.     XI. BUG REPORTS & SUGGESTIONS
  231.  
  232.     XII. REFERENCES
  233.  
  234.     XIII. IN CONCLUSION
  235.  
  236.  
  237.                            I. PROGRAM PURPOSE
  238.  
  239. AEMail is a mail client designed to read, process, compose and send e-mail
  240. from an Amiga computer over the Internet.  It provides an easy to use
  241. graphical interface designed specifically for the Amiga.  It connects to
  242. an Internet server through AmiTCP or any TCP/IP stack compatable with
  243. AmiTCP.  This includes TermiteTCP and Miami.  It uses the AmigaDOS editor,
  244. ed, or any other editor of the user's choosing for developing email
  245. messages.  No other external programs or modules are required.  The POP3
  246. and SMTP protocols are built into the program.
  247.  
  248. AEMail does use the ClassAct Boopsi classes for building some of it's GUI
  249. (Graphical User Interface).  The ClassAct classes required by AEMail are
  250. included with the AEMail Release. If you are using the Amiga OS 3.5,
  251. ClassAct is built into the OS and will not be installed with this
  252. release.
  253.  
  254. The current version of AEMail supports attachments following the MIME
  255. (Multipurpose Internet Mail Extension) outline in RFC 1341, 1521, 1524
  256. (Mailcap files), and 1806 as well as UUENCODED attached files.  Not all of
  257. the features of MIME headers are fully supported and exceptions will be
  258. noted in the documentation.
  259.  
  260. AEMail can also be used as a "MailTo" agent in web browsers, such as
  261. AWeb, IBrowse, and Voyager, which allow the user to specify such an agent
  262. for composing and sending email.
  263.  
  264. You can also call AEMail from another program to send a message created by
  265. that program.
  266.  
  267.  
  268. II. SYSTEM REQUIREMENTS:
  269.  
  270.                                REQUIREMENTS
  271.  
  272. This program can run on any Amiga Operating Systen 2.1 and above.  It uses
  273. the ClassAct Boopsi Classes which are provided with the Installation
  274. script for installations below 3.5.  If you are using Amiga OS 3.5,
  275. ClassAct is built into the OS and does not have to be installed.
  276.  
  277. This program requires a TCP/IP stack compatable with AmiTCP.  It has been
  278. tested with the 4.0 Demo Version of AmiTCP, but will possibly run on
  279. earlier versions at level 2.0 or greater.  It also has been tested under
  280. TermiteTCP and Miami which use a TCP/IP stack that is compatable with
  281. AmiTCP.
  282.  
  283. Other TCP/IP software may or may not be compatable with AmiTCP.  If the
  284. software uses a socket library (bsdsocket.library) with calls that are
  285. compatable with AmiTCP, it possibly will work.
  286.  
  287. If you wish to display MIME attachments from within AEMail, you will also
  288. need a 'Mailcap' file.  You can define and/or edit entries in the
  289. 'Mailcap' file through the "Viewer Page" of the "Configuration Setup".
  290. The actual specifications for the mailcap file are given under the X.
  291. AEMAIL FILES section below.  It is possible to display attachments with
  292. either AmigaDos 2.x or 3.x.  Depending on the program you select to
  293. display the attachments, datatypes may not be required for this display.
  294.  
  295. A sample mailcap file is also provided in the archive and will be
  296. installed when you install AEMail.  This sample mailcap file can be used
  297. without modification on any system running under AmigaDos 3.0 or later
  298. since it uses Multiview (which does use datatypes) as the display agent.
  299.  
  300. If you are using a version of AmigaDos before 3.0, you will have to modify
  301. the mailcap file to specify your own favorite display program for specific
  302. "Content Type/Subtypes".  You can use the "Viewer Page" of the
  303. "Configuration Setup" to do this.
  304.  
  305.                                RESTRICTIONS
  306.  
  307. Only one version of AEMail can be running at a time.  If you are using
  308. AEMail as a "mailto:" mail agent in a browser and you set it up to be
  309. called directly (not through an ARexx script), you can not have AEMail
  310. running when you invoke your browser if you expect to send any email from
  311. your browser.  This is because AEMail will be automatically loaded from
  312. the browser when you click on a "mailto:" link.  This can be avoided if
  313. you call AEMail through an ARexx script which has been provided in the
  314. ARexx directory called "mailto.aem".  Consult the "mailto.readme" file,
  315. also in the ARexx directory, on how to use this script.  Using the ARexx
  316. script allows you to have a running copy of AEMail when your browser is
  317. invoked.
  318.  
  319. This same restiction applies if you call AEMail from an external program
  320. to Queue or Send a message created by that program.  However, if you use
  321. and ARexx Script (or command) you can interface with a running copy of
  322. AEMail.
  323.  
  324.                         AmigaDOS 2.1 Restrictions
  325.                         -------------------------
  326.  
  327. ClassAct does not correctly handle mouse clicks in button gadgets or
  328. listviews under AmigaDOS 2.1 when these mouse clicks occur within a
  329. "tabbed" page.  The mouse clicks work fine outside the page environment so
  330. that the [use], [save], [save as], and [cancel] gadgets work fine as do
  331. the tabs at the top of the screen.  The problem with mouse clicks does not
  332. effect string gadgets, either.
  333.  
  334. This means that under AmigaDOS 2.1, the "Viewer", "ARexx", and "Font"
  335. pages of the Configuration Setup do not work nor does the [Printer
  336. Setup], [Set Screen Mode], [Set Minimum Headers], or [Set Menu Flags]
  337. buttons on the General page.  The [CLR], [DEFAULT], [Set Password] and
  338. call file requester buttons also do not work, but this version has
  339. provided alternate key commands to activate these while editing strings.
  340. (see "Editing String Entry Gadgets" under Section V. USING AEMAIL.)
  341.  
  342. The "Drag Select" option for message list will only work with AmigaDOS 3.0
  343. or above.
  344.  
  345.                        Other ClassAct Restrictions
  346.                        ---------------------------
  347.  
  348. If you are using a Workbench screen that is restricted to 640 by 200
  349. (HIRES) with versions of the OS before 3.5, you will find that there are
  350. some portions the Configuration Setup Window that appear to be cut off.
  351. All the gadgets on the Configuration Setup Window do work correctly,
  352. however.  This problem does not exist with OS 3.5.
  353.  
  354. If you are using a HIRES screen for your Workbench, you can make the
  355. Configuration Setup Window fit correctly by using text overscan to
  356. increase your visable area.  This is not necessary with OS 3.5.
  357.  
  358.  
  359.                         System Addon Restrictions
  360.                         -------------------------
  361.  
  362. While AEMail appears to work fine with a standard configured AMIGA, there
  363. are some possible problems with "system addons" that might not behave
  364. correctly with AEMail.
  365.  
  366. One such problem had been with hacks or commodities that moved a window to
  367. the front when you clicked into it such as the "Click-To-Front" commodity.
  368. The folder window disappeared.  That problem has been corrected.  Any
  369. other hack or commodity that automatically brings the current window to
  370. front either when you click on it or when you pass the cursor over it,
  371. should work now.  Please let me know if you are still having problems.
  372.  
  373. Another commodity that causes problems with AEMail is one that
  374. automatically activates the window under the mouse pointer (AutoPoint).
  375. Since AEMail uses multiple windows, it controls which window is active at
  376. any point in time.  It is not always the window under the mouse pointer
  377. since that might not cause AEMail to react properly.  As a result, if
  378. you activate AutoPoint while AEMail is active, you will experience
  379. flashing windows as AEMail switches control away from the window under the
  380. mouse pointer.
  381.  
  382. Other system configurations may also cause problems with AEMail.  If you
  383. encounter one of these, please send me e-mail describing the problem and
  384. what "add-on" you were using.  If it is a public domain program, it would
  385. be helpful if you included the program as an attached archive to your
  386. message.  (see Section VI, Command Icon Strip:  Compose A message).
  387.  
  388.  
  389.                            Other Considerations
  390.                            --------------------
  391.  
  392. When you call an editor that requires a stack size larger than the default
  393. stack size and that program does not create it's own stack, you will have
  394. to create a script for that editor and set the stack size from that
  395. script.  Increasing the stack size of AEMail will not work because AEMail
  396. establishes it's own stack size and called programs do not inherit stack
  397. size from the calling program.
  398.  
  399. If you are having problems with editors and stack size, you can use the
  400. supplied script for CED (s:AEMced.scr) and modify it to your
  401. specifications.  One warning, however, if you call a word processor you
  402. will need to ALWAYS save the file as ASCII and that program must be able
  403. to accept an already existing ASCII file when it is called.
  404.  
  405. You can send me e-mail by using the Address Book Nickname AEMAIL.  (see
  406. also Section X, Bug Reports and Suggestions)
  407.  
  408.                                REGISTRATION
  409.  
  410. AEMail is shareware.  Versions prior to 1.15 were "freeware".  A shareware
  411. fee of $30 is requested for AEMail.  The shareware fee (US Funds only)
  412. should be sent to:
  413.  
  414.     John Zacharias
  415.     10004 Vanguard Drive
  416.     Sacramento, CA 95827
  417.     USA
  418.  
  419. You must include your Real Name and email address with your remittance.  A
  420. handy form has been provided in the file "registration.form" which you can
  421. print out and use for this purpose.
  422.  
  423. The "registration.form" has an icon which, if you double click on it, will
  424. use the "PrintFiles" program in your SYS:Tools directory to print out the
  425. registration form.
  426.  
  427. Your registration will be acknowledged by email that must be received by
  428. AEMail.  AEMail version 2.30 does have several features that are not
  429. implemented for un-registered users.
  430.  
  431. The features in AEMail 2.30 that are not available to un-registered users
  432. are:
  433.  
  434.     Ability to use multiple signature files.
  435.     Ability to add user defined headers to a message.
  436.     You will not be able to shrink/expand group displays in the Address
  437.         Book displays.  The standard Address Book display will have
  438.         expanded group displays and the Compose window address book
  439.         display will have only the group header displayed.
  440.     Password protection for separate configurations.
  441.     Filtering messages on "Other Message Hdrs".
  442.     Filtering messages on the content of the message body.
  443.     Certain ARexx commands (see Section IX.  AEMAIL AREXX INTERFACE or
  444.         consult the AEMail-ARexx.doc)
  445.     Saving font changes.
  446.     Saving function key and menu assignments for ARexx commands.
  447.     Ability to disable the "Notification" message requester.
  448.  
  449. Future versions of AEMail may also have enhancements that will only be
  450. available to registered users.
  451.  
  452. The display speed is now the same for both registered and unregistered
  453. users.  You may notice, however, that if you select a proportional font for
  454. your message display, you may have a slower message display, especially if
  455. the message contains lines that are too long to fit in the display window.
  456.  
  457. For the un-registered "Freeware" version, permission is given to test and
  458. evaluate the program in return for feedback on the use of the program and
  459. reporting of any bugs encountered.
  460.  
  461. I do ask, however, that, in return for the use of this product, you inform
  462. me of any suggestions you have and of any bugs that you encounter.  You
  463. can do that by sending e-mail to me using the Nickname AEMAIL which can be
  464. found in your Address Book when you first load AEMail.  (see also Section
  465. X, Bug Reports and Suggestions)
  466.  
  467. AEMail no longer automatically sends the special "Notification" message
  468. when you send your first message.  Instead, when you first load a new
  469. version of AEMail, a special requester will appear asking if you want to
  470. send the notification message for notification of updates and giving you
  471. the ability to select what information you want to send.
  472.  
  473.  
  474.                           NOTIFICATION REQUESTER
  475.  
  476. When you first load a new version of AEMail, a special requester will
  477. appear asking if you want to send a notification message for notification
  478. of updates and giving you the ability to select what information you want
  479. to send.  You can cancel this message, but if you do, the requester will
  480. appear each time you load AEMail.  Tf you are a registered user and you
  481. cancel, you will be given the opportunity to suppress the message the next
  482. time you load AEMail.  For unregistered users the requester will appear
  483. each time you load AEMail whether or not you send the notification or
  484. cancel.
  485.  
  486. The requester looks like this:
  487.  
  488.   =======================================================================
  489.   [o] Send AEMail Notification Request                                  |
  490.   ====================================================================  |
  491.   |  ---------- ---------                                             | |
  492.   | | Identity | Options |                                            | |
  493.   | |          |_________|___________________________________________ | |
  494.   ||                                                                 || |
  495.   || Please complete if you want notification of updates sent to you || |
  496.   ||                                                                 || |
  497.   ||  Email Address: [ userid@domain                              ]  || |
  498.   ||                                                                 || |
  499.   ||        Version: [ 2.20         ] Serial Number: [nnnnnnnnn   ]  || |
  500.   ||                                                                 || |
  501.   || ----------------------Optional Information--------------------- || |
  502.   |||                                                               ||| |
  503.   |||    Name: [                                                  ] ||| |
  504.   |||                                                               ||| |
  505.   ||| Address: [                                                  ] ||| |
  506.   |||                                                               ||| |
  507.   |||    City: [             ] State: [         ]   Zip: [        ] ||| |
  508.   |||                                                               ||| |
  509.   ||| Country: [      ] [ ] Do not continue to show this on startup ||| |
  510.   || --------------------------------------------------------------- || |
  511.   | ----------------------------------------------------------------- |_|
  512.   | [       Queue       ] [      Send Now      ] [      Cancel      ] |/|
  513.   ======================================================================|
  514.  
  515. The Email Address will be filled in with information from your
  516. configuration data, Version by the current version number of AEMail, and
  517. Serial Number by information your registration data.  If your version of
  518. AEMail is unregistered, the words UNREGISTERED will appear in the Serial
  519. Number.  The Version number and Serial Number can not be changed, but you
  520. can change the email address.  All of this is required information.
  521.  
  522. Below this is optional data although your name will be filled in with
  523. either your real name from the configuration data (if unregistered) or the
  524. name from your registration data.  You can clear or change this data if
  525. you wish.  You can also add your address, city, state or province, zip or
  526. postal code, and country.
  527.  
  528. At the bottom of the screen are three buttons: [Queue], [Send Now], and
  529. [Cancel].  [Queue] will queue the notification message in the QUEUED folder,
  530. [Send Now] will send the notification message immediately provided you are
  531. connected to the Internet.  If you are not connected, [Send Now] will
  532. queue the message.  [Cancel] will cancel the notification requester unless
  533. "Do not continue to show this on startup" is checked.  Unregistered users
  534. will not be able to check this item and the notification request will
  535. continue to appear when you startup AEMail regardless of whether you
  536. have previously queued or sent the request.  However you can cancel it at
  537. any time.  The close gadget at the top of the window will act the same as
  538. [Cancel].
  539.  
  540. The Options page (indicated by the Options tab) will send optional
  541. information about your configuration if you so desire.  It is primarily to
  542. provide me with information about your setup in the event you have
  543. problems using AEMail.  The Options page looks like this:
  544.  
  545.  
  546.   =======================================================================
  547.   [o] Send AEMail Notification Request                                  |
  548.   ====================================================================  |
  549.   |  ---------- ---------                                             | |
  550.   | | Identity | Options |                                            | |
  551.   | |__________|         |___________________________________________ | |
  552.   ||                                                                 || |
  553.   || [ ] POP Server is: your-POP-Server-name                         || |
  554.   ||                                                                 || |
  555.   || [ ] SMTP Server is: your-SMTP-Server-name                       || |
  556.   ||                                                                 || |
  557.   || [ ] SMTP Domain Name is: your-domain-name                       || |
  558.   ||                                                                 || |
  559.   || [ ] Editor Call is: the-call-line-for-your-editor               || |
  560.   ||                                                                 || |
  561.   || [ ] Exec Version is: exec-version-number                        || |
  562.   ||                                                                 || |
  563.   || [ ] Display ID is: display-ID-for-your-screen-mode              || |
  564.   ||                                                                 || |
  565.   || [ ] Current Config file is: path-and-name-of-your-config-file   || |
  566.   ||                                                                 || |
  567.   || [ ] Mail Directory is: path-to-your-mail-directory              || |
  568.   ||                                                                 || |
  569.   | ----------------------------------------------------------------- |_|
  570.   | [       Queue       ] [      Send Now      ] [      Cancel      ] |/|
  571.   ======================================================================|
  572.  
  573.  
  574. Checkmark those items you want sent with the notification message.
  575. Perhaps the most inmportant items are your Editor Call (if you are having
  576. problems with your editor), the Exec Version, and the Display ID.
  577. However, you do not have to send any of this information.
  578.  
  579. When the notification message is received your email address is placed in
  580. a database for informing you of updates.  If you do not want to be so
  581. informed, cancel and do not send the notification message or send email to
  582. "AEMail" to that effect and your name will be removed from the database.
  583.  
  584. Please note that the notification message requester will appear when you
  585. upgrade to a new version of AEMail even though you may have previously
  586. sent a notification message for an earlier version.  This lets us know
  587. which version you are using.  Some of the data in future notification
  588. messages may also change to help give feedback on how AEMail is being used
  589. and what setup you are using.
  590.  
  591. Also, if you are using multiple configuration files, a separate
  592. notification message will appear the first time you you load any
  593. particular configuration.  If you re-install AEMail for any reason you may
  594. have an additional Notification message request.
  595.  
  596.  
  597.                             III. INSTALLATION
  598.  
  599.  
  600. The AEMail Install Script uses the Installer program first provided by
  601. Commodore and later revised by Amiga Technologies.  You should use the
  602. Install_AEMail script to install AEMail.  It is not recommended that you
  603. attempt to install AEMail by hand since some actions are necessary through
  604. the install script.  This is especially true if you are attempting to
  605. install a registered version of AEMail!
  606.  
  607.     Installer and Installer project icon
  608.     (c) Copyright 1995-96 Escom AG.  All Rights Reserved.
  609.     Reproduced and distributed under license from Escom AG.
  610.  
  611.     INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE;
  612.     NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  613.     OR RESPONSIBILITY IS ASSUMED.
  614.  
  615. Starting with Version 2.00 of AEMail, the Installation script was
  616. completely re-written from previous versions.  You can now define multiple
  617. users with the install script and use the install script to add or update
  618. users as well as delete users (Version 2.30 and above).
  619.  
  620. The script was further modified for Version 2.20 to place additional edits
  621. when naming configuration files and your mail directory.  The script also
  622. installs the ClassAct classes required by AEMail if you are installing with
  623. an OS prior to 3.5.  If you are installing to OS 3.5, it is not necessary
  624. to install the ClassAct classes since they are built into the OS.
  625.  
  626. In OS versions prior to 3.5 you will be asked if you want to install
  627. ClassAct.  It is not necessary to do this if you are already have ClassAct
  628. installed on your system (either by a previous AEMail install or with
  629. another program using ClassAct).
  630.  
  631. Other changes to the Version 2.20 installation script include:
  632.  
  633.     Changing RAM: to T: for saving temporary files.  On most Amigas, T: is
  634.     in RAM:  However, in some low memory situations, a user may assign T:
  635.     to a hard drive.  By changing RAM: to T:, users with low memory
  636.     conditions can still install AEMail.
  637.  
  638.     If you have previously installed a version of AEMail 2.00 or above, you
  639.     can bypass the "Configuring Users" portion of the script as long as you
  640.     do not want to add to your users or update a user.
  641.  
  642. Further changes to the Version 2.30 installation script include:
  643.  
  644.     The ability to delete users.
  645.  
  646.     The installation script now asks what type of installation you are
  647.     performing: a demo version, a previously registered version, or a new
  648.     registered version.
  649.  
  650. Please read these instructions before attempting to install AEMail.
  651.  
  652. If you have the diskette version of AEMail, you will find that it is now a
  653. two disk set.  Place Disk_1 in your drive to start the installation.  At
  654. the appropriate time you will be asked to insert "AEMail_V2.30-Disk_2".
  655.  
  656. If you are installing from a version obtained over the Internet or from the
  657. AEMail CD-ROM, you will not get this message.
  658.  
  659. To install AEMail simply double click on the "Install_AEMail icon".  The
  660. install script provides two user levels that the user can choose:
  661.  
  662.     Intermediate    (control of configuration parameters only)
  663.     Expert          (control of configuration and where files are placed)
  664.  
  665. See below for actions that are different between the two user levels.
  666.  
  667. The first thing that the Install script will ask is what type of
  668. installation you are performing:
  669.  
  670.     A Demo Version
  671.     A Previously Registered Version
  672.     A New Registered Version
  673.  
  674. If you are installing a new registered version you will need a key code
  675. which was provided when you purchased AEMail.  You will not be able to
  676. continue with the installation if you can not provide the correct key code.
  677. In this event you should re-install using the Demo Version and contact the
  678. author at jzachar@calweb.com for further instructions.
  679.  
  680. Likewise, if you are installing a previously registered version, the
  681. installion script will attempt to locate your registration information in a
  682. file called .registration in you main AEMail program directory.  If your
  683. previous installed version was prior to 2.00, it will look for the
  684. registration file in AEMail:.registration.  If it can't be found you will
  685. be instructed to install at the Demo Version level and to contact
  686. jzachar@calweb.com for further instructions.  Before doing that, however,
  687. execute your newly installed AEMail and see if it is a registered version.
  688.  
  689. The Install script then makes an attempt to determine which TCP/IP stack
  690. that you have installed.  This controls which defaults will be taken.  The
  691. way the install scripts knows which TCP/IP stacks are present is as follows
  692. (you must have installed the particular stack before installing AEMail):
  693.  
  694.     AmiTCP:     This is controlled by the presence of the AmiTCP: assign
  695.                 statement and the presence of the AmiTCP:bin drawer.  The
  696.                 AmiTCP:  assignment and the AmiTCP:bin drawer were
  697.                 automatically created when you installed AmiTCP.
  698.  
  699.  
  700.     Miami:      This is controlled by the presence of the Miami: assign
  701.                 statement.  When you installed Miami you should have let
  702.                 the install create the Miami: assign.  This was only
  703.                 available under later versions of Maimi.
  704.  
  705.                 While the Miami:  assign is not an absolute requirement
  706.                 if you are using Miami, it is required if you intend
  707.                 to use the supplied "startnet.miami" script without
  708.                 modification.  This script locates Miami with Miami:Miami
  709.                 which depends on the Miami assign.  If the Miami assign is
  710.                 not present you would have to modify the script to use the
  711.                 full path name of where Miami is located.
  712.  
  713.     TermiteTCP: This is controlled by the presence of the TermiteTCP.prefs
  714.                 envronomental variable.  Also, if you want to pick up
  715.                 some of the other TermiteTCP variables, such as email
  716.                 address, you must have run TermiteTCP prior to installing
  717.                 AEMail (TermiteTCP does not have to be online, however).
  718.  
  719. The install script will ask you to verify which TCP/IP stack you are using.
  720. A fourth alternative "Other" is provided if you have another TCP/IP stack
  721. or you have not as yet installed your chosen stack software.
  722.  
  723. If you have multiple stacks installed, the initial stack selection is made
  724. in this priority:
  725.  
  726.     Miami
  727.     AmiTCP
  728.     Termite-TCP
  729.  
  730. You can, of course, change this with the requester.
  731.  
  732. If you select the Intermediate user level, the following actions will be
  733. taken:
  734.  
  735.     If you have previously installed AEMail with a version 1.10 or greater,
  736.         the install script will determine where AEMail was previously
  737.         installed from the ENV:AEMail_Dir environmental variable.
  738.  
  739.     If you have not previously installed AEMail or you are updating from
  740.         an AEMail version prior to 1.10, the AEMail executable file will be
  741.         placed in AmiTCP:bin if the AmiTCP stack was selected or, if one of
  742.         the other stacks was selected, on the largest partition on your
  743.         hard drive.
  744.  
  745.         Note: No special directory will be created if AmiTCP is
  746.         selected, otherwise a directory called "AEMail" will be created
  747.         for containing the AEMail executable.  When the installation
  748.         script terminates it will tell you where it placed the AEMail
  749.         executable.
  750.  
  751.         The reason that AEMail is placed in the AmiTCP:bin drawer if the
  752.         AmiTCP:  assignment is present and you selected AmiTCP as your
  753.         TCP/IP stack, is that the "startnet" and "stopnet" scripts for
  754.         AmiTCP should be in the same directory that contains AEMail if they
  755.         are to work without modification.  The AmiTCP installation places
  756.         these scripts in the AmiTCP:bin drawer.
  757.  
  758.     For OS Versions prior to 3.5, the ClassAct classes will be normally
  759.         installed to your SYS:Classes drawer.  You will be asked if you
  760.         want the 020 optimized version of the classes.  If you are running
  761.         on an 020 or greater processor, reply "yes".  With OS 3.5, the
  762.         ClassAct classes will have been installed when the OS was
  763.         installed.
  764.  
  765.     The documentation files that you want copied will be copied to a drawer
  766.         called "documentation" in the drawer which contains the AEMail
  767.         executable.
  768.  
  769.     A special ARexx documentation file (which is also part of the
  770.         AEMail.doc and AEMail.guide files), is placed in a drawer called
  771.         "ARexx" in the drawer which contains the AEMail executable.  This
  772.         drawer will also contain some sample ARexx scripts.
  773.  
  774.     If you want the AEMail.readme file, it will be copied to the directory
  775.         containing your AEMail executable.
  776.  
  777.     The ARexx scripts StartNet.Miami and StopNet.Miami will be copied to
  778.         the directory containing your AEMail executable providing they are
  779.         not already there.  This prevents copying over scripts that may
  780.         have been previously modified.
  781.  
  782.     A handy registration form called "registration.form" will be available
  783.         in your main AEMail directory.  It has an icon which, if you double
  784.         click on it, will use the "PrintFiles" program in your SYS:Tools
  785.         directory to print out the registration form.
  786.  
  787.     You will be asked how many users you want configured.  See the section
  788.         below on Configuring Users to see what happens here.
  789.  
  790.     If you are updating a user, you can change their mail directory.
  791.         However, if you are creating a new mail directory rather than using
  792.         an existing one,  you will start out with a blank address book and
  793.         empty standard folders.
  794.  
  795.     If you are running under AmigaDos 3.0 or greater, the supplied
  796.         mailcap file will be copied to the mail directory for each user
  797.         unless a mailcap file already exists in that user's mail directory.
  798.         No mailcap file will be copied if one already exists in the user's
  799.         mail directory or if you are using AmigaDos 2.1.
  800.  
  801.     An AEMAIL2: assign statement pointing to the drawer containing your
  802.         AEMail executable will automatically be placed in your
  803.         S:User-Startup file.
  804.  
  805.     An "ASSIGN C: SYS:REXXC ADD" will also be added to your s:User-Startup
  806.         file to provide a path to your AREXX commands.
  807.  
  808. The following additional capabilities are provided when you install at the
  809. Expert level:
  810.  
  811.     You will be able to choose which directory AEMail will be installed in.
  812.         If you are installing AEMail for first time, this may be desireable
  813.         rather than installing in the largest partition on your hard drive.
  814.         The default directory that is selected will be the one that would
  815.         have been selected under the Intermediate level.
  816.  
  817.     You will be able to choose which directory you wish to install your
  818.         Documentation files in.  WARNING: for the Help function to properly
  819.         work, the AEMail.guide file must be in the "documentation" drawer
  820.         within the drawer which contains the AEMail executable.  You can
  821.         change the location of the .guide file by using the "HELP=" Tool
  822.         Type.  This must be done manually.  The Install script WILL NOT set
  823.         this tool type.
  824.  
  825.     You will be able to choose which directory you wish to install your
  826.         ARexx files in.  You might want to select the Rexx: directory for
  827.         this so that the supplied ARexx scripts become immediately
  828.         available.
  829.  
  830.     If you want a mailcap file other than the one provided, you can select
  831.         where you want this file copied from.  If you want to use the
  832.         alternate mailcap provided in the ARexx drawer for displaying HTML
  833.         documents with your browser, you could specify the AEMail ARexx
  834.         drawer for the source of the mailcap.
  835.  
  836. As noted above, the default drawer in which your documentation is placed is
  837. a drawer called "Documentation" in the drawer containing your AEMail
  838. executable.  This is different from versions prior to 1.50 where the
  839. documentation files were placed in the same drawer as the AEMail
  840. executable.  Documentation files located in the drawer containing your
  841. AEMail executable WILL BE deleted by the installation script.  If you want
  842. these retained you will have to re-name or save them yourself.
  843.  
  844. Towards the beginning of the script, after you have identified your TCP/IP
  845. stack, the script will determine if you have already installed the current
  846. version of AEMail.  If you have, you will be asked if you want to do a Full
  847. Install or want to add, delete and/or update users.  If you just want to
  848. add, delete or update users, you will go immediately to the "Configuring
  849. Users" section described below.
  850.  
  851.  
  852.                              Configuring Users
  853.                              -----------------
  854.  
  855. You can set up multiple users of AEMail from the Install Script.  Each user
  856. will be provided a Project Icon named as the user wishes.  This project
  857. icon will point to the AEMail executable and will be created with certain
  858. required Tool Types as "configuration" items.  The Project icons will be
  859. created with the Install_AEMail script.
  860.  
  861. If you have previously installed a version of AEMail 2.00 or above, you
  862. have already established your users.  In this situation all of the users
  863. that have been previously defined will be displayed and you will be asked
  864. if you want to "Add/Delete/Update Users" or "Accept Current Users".  If you
  865. reply with "Accept Current Users", the user configuration section will be
  866. bypassed.
  867.  
  868. If you have not installed AEMail previously or your previously installed
  869. version is prior to 2.00, you will be asked how many users with different
  870. email addresses you wish to configure AEMail for.  You must have at least
  871. one user.  Certain questions will then be asked for each user so that
  872. appropriate Project icons can be created with the appropriate Tool Types.
  873.  
  874. If you already have established users and replied "Add/Delete/Update Users"
  875. you will first be asked if you want to delete any users.  If you do, your
  876. existing users will be displayed and you can select the one you want to
  877. delete.
  878.  
  879. The script will determine the Configuration file used by the user you want
  880. deleted.  It will display a requester asking if you want to delete this
  881. configuration file.  Unless you want to use this configuration file again,
  882. you will want to delete it.
  883.  
  884. The script will then determine the Mail directory for the user you want
  885. deleted.  Again it will ask if you want this mail directory deleted.  If
  886. the mail directory is being used by another user you should not delete it.
  887.  
  888. After that user is deleted you will be asked if you want to delete
  889. another user. If you don't, you will then be asked how many users you want
  890. to add or update.  You can reply 0 to this message which will then bypass
  891. establishing or changing any users.
  892.  
  893. As each user is processed you will get a message asking you to select the
  894. name of the icon you want your user to have.  Since you can both create a
  895. new user or update an existing user, you will be present with a list of
  896. choices that looks like this:
  897.  
  898.     Create new icon
  899.     name-of-previously-defined-user-1
  900.     name-of-previously-defined-user-2
  901.     ...........
  902.     name-of-previously-defined-user-n
  903.  
  904. Only the names of previously defined users will appear in this list.  If
  905. you select any of the users or the "Create new icon" entry you will get a
  906. message asks you to enter (or confirm) the name of the user (icon name)
  907. that asks you want the user to have.  When you select "Create new icon" a
  908. default name will be used that will be one of the following:
  909.  
  910.     AEMail_User_1
  911.     AEMail_User_2
  912.     AEMail_User_3
  913.     ...........
  914.  
  915.     AEMail_User_n
  916.  
  917. You can change the name or use the one provided.  You will then be told if
  918. the icon already exists or not and asked to confirm that this is the
  919. correct name.  If you are editing a previously created icon, that icon, of
  920. course will exist.  You will be given an opportunity to re-enter the name
  921. if you decide it is wrong.
  922.  
  923. If you are updating from a previous version of AEMail (before 2.00), you
  924. will already have a "Tool" icon for AEMail.  If you select "AEMail" as the
  925. name, the "tool" icon will be turned into a Project icon for your primary
  926. user and all existing Tool Types will be obtained as default values.  If
  927. you choose to change the name of the icon, the "AEMail" tool icon will
  928. remain.
  929.  
  930. WARNING:  Do not try to DELETE any icon called "AEMail" (tool or project)
  931. AFTER you have installed AEMail using the workbench "Icons/Delete..."  menu
  932. item.  This will delete the AEMail executable as well.  If you don't want
  933. the "AEMail" icon it is best to delete it BEFORE installing AEMail or use
  934. the delete function described above to delete the icon.
  935.  
  936. The required Tool Types that will be created for each user's Project icon
  937. are:
  938.  
  939.     CONFIG=
  940.     MAIL_DIR=
  941.     PASSPROTECT=YES
  942.  
  943. The CONFIG= Tool Type points to the configuration file for that user.  This
  944. configuration file must be unique for each user.  Under both install
  945. options (Intermediate and Expert), a file requester will appear for you to
  946. select the configuration file name.  If you are not updating an existing
  947. user, this configuration file will not exist so you can enter whatever you
  948. like (providing a file with the same name is not present).  You can select
  949. any drawer, but either the drawer containing the AEMail executable or the
  950. s:  directory are recommended.
  951.  
  952. If you start AEMail from the shell without any arguments, you will need to
  953. name your primary user's configuration file aemail.cnfg in the s:
  954. directory.
  955.  
  956. If you are doing a full install and you have a s:aemail.cnfg file, this
  957. file will automatically be selected as your default configuration file for
  958. your first user provided no configuration file was previous specified in
  959. the "AEMail" Tool Types.  If you install at the "Expert" level, you will
  960. be able to copy and/or rename this file to another location.
  961.  
  962. The MAIL_DIR= Tool Type is used to specify where your mail directory is
  963. located.  In versions of AEMail prior to 2.00, the AEMail:  assign was used
  964. to specify the mail directory location and the Tool Type was only used if
  965. the mail directory differed from that.  This is no longer the case.  With
  966. version 2.00 and above, the AEMail:  ASSIGN statement is no longer used,
  967. the mail directory will always be specified by the MAIL_DIR= Tool Type.
  968. After installing a user you can change their mail directory by either
  969. changing this Tool Type or by running the Installation script again to
  970. update this user.
  971.  
  972. If you are updating from a version of AEMail prior to 2.00, the AEMail
  973. ASSIGN will be used to specify the default MAIL_DIR unless a MAIL_DIR=
  974. Tool Type was previously specified in an updated icon.
  975.  
  976. For new users, you will be given an opportunity to accept the default as
  977. the mail directory or specify a new mail directory location for each user.
  978. The MAIL_DIR does not have to be unique to each user.  Two or more users
  979. can share the same mail directory.  If the mail directory you specify is
  980. not present, it will be created.
  981.  
  982. The PASSPROTECT=YES Tool Type is used to password protect the mail
  983. directory for a particular user (only available for registered users).  You
  984. will be told whether the mail file is currently password protected or not
  985. and then be asked if you want to password protect the mail directory for
  986. this particular user.  If the file was previously password protected, you
  987. can turn that feature off by replying 'No'.  To continue password
  988. protection you will have to reply 'yes'.  The password that is used to
  989. password protect the directory is the same one that is used to access the
  990. POP server by that particular user.
  991.  
  992. Previously an INTERLACE=YES Tool Type was used to specify the screen mode
  993. that AEMail would initially open on.  This Tool Type is now obsolete.
  994. AEMail will now initially open on whatever screen mode is set for your
  995. Workbench screen.  After initially loading AEMail, you can change the
  996. screen mode through the Configuration Edit screen, General page.
  997.  
  998. You will also be able to provide additional configuration data for each
  999. user that will be stored in the Tool Types parameters of the AEMail Project
  1000. icon for that user.  If the user has an existing Configuration file, you
  1001. will be asked if you want to re-configure this user's data.  If you do, the
  1002. existing configuration file will be renamed with ".old" appended to it.  If
  1003. the user does not have an existing configuration file, you will be asked if
  1004. you want to configure now or wait until AEMail is first loaded.
  1005.  
  1006. Since you can change the configuration data from AEMail, the Configuration
  1007. file always takes precedence over the Tool Types.  The only exceptions to
  1008. this are the name of the configuration file (CONFIG=) and the name of the
  1009. mail directory (MAIL_DIR=).  That is why any existing configuration file
  1010. is renamed to avoid resetting the configuration data when AEMail is first
  1011. loaded.
  1012.  
  1013. Certain configuration parameters must be provided before AEMail will run.
  1014. These configuration parameters are provided either by Tool Types in the
  1015. AEMail icon or through a special Configuration Setup Window when you first
  1016. run AEMail and saved in the user's configuration file.
  1017.  
  1018. If these parameters are not provided by Tool Types (through the
  1019. installation script) or by an existing configuration file, the
  1020. Configuration Setup Window will be displayed upon the initial startup of
  1021. AEMail.  You can not proceed beyond this configuration setup until certain
  1022. required configuration parameters are provided.  The absolute minimum
  1023. configuration parameters that must be provided are:
  1024.  
  1025.     POP3 UserID
  1026.     Password
  1027.     Your email Address
  1028.     POP Server Name
  1029.     SMTP Server Name
  1030.     Domain Name
  1031.     Edit Call
  1032.  
  1033. If you decide to configure using Tool Types, the installation script will
  1034. try to automatically configure certain items to default values.  These
  1035. include the switch for deleting mail from your POP Server once it has been
  1036. transferred to your Amiga and the switch for stripping duplicate messages.
  1037. The edit call will default to c:ed and will open the editor on the
  1038. Workbench.  Also, if you have your TCP/IP stack loaded (not necessarily
  1039. on-line), it will obtain certain default items from environmental variables
  1040. stored by the stack software.
  1041.  
  1042. The installation script will allow you to provide additional configuration
  1043. parameters as Tool Types in your AEMail icon or to change the default ones.
  1044.  
  1045. A POP Server name and a SMTP Server name must be provided.  However, if
  1046. they are missing AND, if the Domain Name has been specified, default
  1047. values will also be assigned to these items.  These default values will
  1048. prepend 'POP.' to the domain name for the POP server and 'SMTP.' to the
  1049. domain name for the SMTP Server as defaults.  Please note:  these may NOT
  1050. be correct for your POP and SMTP servers.  If they are not, you will have
  1051. to change these items with the installation script.  Some Internet Service
  1052. Providers use mail.  prepended to the domain server for both the POP and
  1053. SMTP servers.
  1054.  
  1055. If you have a problem understanding what should be entered with the
  1056. install, use the HELP function of the Install script.  Here is some of the
  1057. help information from the script:
  1058.  
  1059.   "The domain name is usually the part of your e-mail address that follows"
  1060.   "the '@' sign.  If something else is required by your Internet Provider,"
  1061.   "provide it here."
  1062.  
  1063.   "As an example, my email address is:"
  1064.  
  1065.         "jzachar@calweb.com"
  1066.  
  1067.   "The domain name for my Internet provider is therefor 'calweb.com'."
  1068.  
  1069.  
  1070.   "POP Server.  POP stands for 'Post Office Protocol' and your "
  1071.   "POP Server is the name assigned to the host computer that holds "
  1072.   "your Internet mail.  Normally this would be 'pop.' or 'mail.' "
  1073.   "prepended to your Domain name."
  1074.  
  1075.   "Consult your Internet provider if the POP Server is called "
  1076.   "something other than the above."
  1077.  
  1078.  
  1079.   "SMTP Server.  SMTP stands for 'Simple Mail Transfer Protocol' and "
  1080.   "your SMTP server is the name assigned to the host computer that "
  1081.   "sends your Internet mail.  Normally this would be 'smtp.' or 'mail.' "
  1082.   "prepended to your Domain name"
  1083.  
  1084.   "Consult your Internet provider if the SMTP Server is called "
  1085.   "something other than the above."
  1086.  
  1087.  
  1088. If you have installed and ran your TCP/IP stack before you installed
  1089. AEMail, the only configuration parameter you may have to provide is your
  1090. password.  If you are using TermiteTCP, the POP3 UserID and the SMTP Domain
  1091. Name are extracted from the email address that you gave TermiteTCP.  Other
  1092. stacks provide environmental variables to store this information.  If these
  1093. are not the correct values you will have to change them in either with the
  1094. Installation script or through the Identity page of the Configuration
  1095. Setup Window.
  1096.  
  1097. One of the things that is needed to run AEMail is an editor.  By default
  1098. AEMail will use the AmigaDOS editor, ed, which comes with all Amigas.
  1099. However, you can change this through the install to any editor that you
  1100. want provided that you have specified that you want to configure AEMail
  1101. when you do the install.
  1102.  
  1103.                            Other Considerations
  1104.                            --------------------
  1105.  
  1106. If you are using Miami as your TCP/IP software, special startnet.miami and
  1107. stopnet.miami scripts have been provided with the install of AEMail.  If
  1108. you select Miami as your TCP/IP stack and the Miami assign is present, the
  1109. install script assumes the Miami startnet and stopnet scripts should be
  1110. used.
  1111.  
  1112. If you are using AmiTCP, that software provides its own StartNet and
  1113. StopNet scripts.  They are usually in your AmiTCP:bin directory.  It is
  1114. recommended that you place AEMail in the same directory that contains these
  1115. AmiTCP StartNet and StopNet scripts, although this is not an absolute
  1116. requirement.  If AEMail is placed in a different directory, you might have
  1117. to modify these scripts to work properly.  If the directory containing your
  1118. StartNet or StopNet scripts is NOT the AmiTCP:bin directory or the scripts
  1119. have names different from "startnet" or "stopnet", you will have to change
  1120. the default values for the STARTNET and STOPNET tool types.  You can do
  1121. that with the installation script.
  1122.  
  1123. If you are using TermiteTCP, there are no Start Net or Stop Net scripts.
  1124.  
  1125. SPECIAL NOTE FOR MIAMI USERS:  In the TCP/IP Settings page on Miami, the
  1126. "Down when Offline" item should be checked and the settings SAVED.  If this
  1127. item is not checked, it will take AEMail 80 seconds to determine that Miami
  1128. is offline if Miami is loaded but not online.
  1129.  
  1130. WARNING:  If you are updating and you change the mail directory for a
  1131. specific user, you will lose all previous folder configuration data.  You
  1132. might also lose your registration information if you are a registered user.
  1133. In versions prior to 2.00, the registration information was stored in your
  1134. mail directory.  Version 2.00 and later stores it in the AEMail program
  1135. directory.  The installation script will attempt to copy this information
  1136. from the mail directory to the program directory.  If the installation
  1137. script can not find your old mail directory (usually by the AEMail:  assign
  1138. statement, you will need to copy this data yourself from your old
  1139. mail directory to the new mail directory.
  1140.  
  1141. The mail directory can start out empty.  The AEMail program will generate
  1142. any necessary configuration and support files required.  The mail directory
  1143. directory can be anywhere on any one of your hard drive partitions (or on a
  1144. floppy or other read/writable media); it does not have to be in any
  1145. specific directory; but it must be mounted when you execute AEMail.
  1146.  
  1147. As stated above, you will need a "mailcap" file if you want to display MIME
  1148. mail attachments.  A sample mailcap file is provided on the AEMail program
  1149. disk which uses MultiView to display audio, images, and video content types
  1150. provided that you have the appropriate datatypes loaded into your system.
  1151. This, of course, requires AmigaDos 3.0 or higher.  If you are using
  1152. AmigaDos 2.1, the mailcap file needs to be modified to reflect the display
  1153. programs that you want.  The installation script at the Expert level will
  1154. help you do this or you can do this with the "Viewer" page of the
  1155. Configuration Setup Window.
  1156.  
  1157. If you are running under AmigaDos 3.0 or higher, the installation script
  1158. will automatically move the supplied mailcap file to the mail directory
  1159. for each user unless a mailcap file already exists there or unless you
  1160. specified a different location for a pre-existing mailcap file (Expert
  1161. level only).
  1162.  
  1163. The mailcap file specifications are given in AEMail documentation and guide
  1164. files.
  1165.  
  1166. A special mailcap file is provided in the "ARexx" drawer to allow you to
  1167. display HTML attachments with your browser.  If you wish to use this
  1168. feature you will have to copy the mailcap file in the ARexx drawer to your
  1169. mail directory.  This can be done with the installation script at the
  1170. Expert level.  Read the html.readme file in the ARexx drawer for details of
  1171. this special mailcap file.
  1172.  
  1173. The mailcap file can also be created or edited online with AEMail through
  1174. the "Viewer" page of the Configuration Setup Window.
  1175.  
  1176. AEMail gets the current time zone from either the locale.prefs file that
  1177. is part of AmigaDos or the tz envronmental variable.  See "Handling of
  1178. Time Zones" below for further information on this.
  1179.  
  1180. When the installation script terminates it will store the directory in
  1181. which it placed AEMail in the Environmental variable "AEMail_dir".  It also
  1182. creates an assign statement in your User Startup for the AEMail program
  1183. directory called AEMail2:.  Starting with version 2.00 it will also store
  1184. the version number of the current AEMail in the environmental variable
  1185. "AEMail_Ver".  This facilitates updating to future releases of AEMail.
  1186. The version 1.30 and later installation scripts, at all installation
  1187. levels, will look for the AEMail_dir Environmental variable to try to
  1188. determine where to place AEMail.
  1189.  
  1190.                      Setting the Time Zone for AEMail
  1191.                      --------------------------------
  1192.  
  1193. AEMail will handle time zones in both full hour and half hour increments.
  1194. AEMail uses either the "tz" environmental variable, a special "aem_tz"
  1195. environomental variable, or the "locale.prefs" file that is part of
  1196. AmigaDos to determine your local time zone.  The "locale.prefs" file will
  1197. only allow for full hour time zone offsets.  You can use the "tz"
  1198. environmental variable for half hour time zones, but, if this variable is
  1199. used by other programs in your system it is suggested that you use the
  1200. "aem_tz" variable instead.
  1201.  
  1202. To set the time zone in the "locale.prefs" file, execute the Locale
  1203. program under your Prefs directory by double clicking on the Locale icon.
  1204. At the bottom right of the Locale Preferences window you will see a world
  1205. map with a white line through it that indicates the time zone that you are
  1206. in.  To change this, click on the country you are in.  The white line will
  1207. move to that position and the Time Zone heading at the top of the map will
  1208. reflect the time zone offset for your part of the world.  Then click on
  1209. the [Save] gadget at the bottom of the window.
  1210.  
  1211. Currently AEMail first looks for the environmental variables "aem_tz" or
  1212. "tz".  The format for "tz" is dictated by SAS_C and should be aaabbbccc
  1213. where aaa is the abbreviation for local standard time, bbb is the offset
  1214. in hours from GMT (-11 to 12) which is SUBTRACTED from GMT to get the
  1215. local standard time.  ccc is the abbreviation for local daylight savings
  1216. time or "summer time" (in the United Kingdom or Europe).  If the time zone
  1217. has daylight savings time this should be present even if daylight savings
  1218. time is not currently in effect (contrary to the specification for "Tz"
  1219. for the SAS-C compiler).  AEMail automatically determines when DST or
  1220. "Summer Time" is in effect.
  1221.  
  1222. AEMail also recognizes an alternate form of "tz" where aaa and ccc can be
  1223. abreviations longer than 3 characters.  This is desireable in some
  1224. European countries.  AEMail will also recognize time zones in increments
  1225. of one half hour.  To specify an half hour time zone, specify it as + or -
  1226. hhmm.  As an example:  +230 would specify a time zone in which 2 and a
  1227. half hours are SUBTRACTED from GMT.
  1228.  
  1229. You can enter the above with the "tz" environmental variable, but since
  1230. this variable might be used with other programs in it's strict sense, an
  1231. alternate environmental variable has been provided called "aem_tz".
  1232.  
  1233. If "aem_tz" is present it will take precedence over "tz".
  1234.  
  1235. If the "tz" or "aem_tz" environmental variables are not present, the
  1236. system then attempts to get the time zone offset from the "locale.prefs"
  1237. file.  Only the time zone offset is present in this file.  The
  1238. abbreviations for local standard time and daylight savings time are
  1239. obtained from a table that is by no means complete.  Only the time zone
  1240. abbreviations for the United States, Canada, and the United Kingdom are
  1241. contained in this table, so one of the environmental variables is
  1242. preferred.
  1243.  
  1244. if neither the "tz" nor "aem_tz" environmental variables nor the
  1245. "locale.prefs" file are present, the system defaults to CST with an offset
  1246. of 6.
  1247.  
  1248. NOTE:  the standard header in an email message has the time zone offset
  1249. sign reversed from that of the "locale.prefs" and the environmental
  1250. variables.  AEMail automatically makes this reversal, so the offset should
  1251. be set to positive for US time zones and negative for European time zones.
  1252. They will appear as negative (for US) and positive (for Europe) in the
  1253. Date:  header.
  1254.  
  1255. You can set the "tz" or the "aem_tz" environmental variables by using the
  1256. SETENV AmigaDos Command.  This must be done from the shell.  The syntax to
  1257. use is as follows:
  1258.  
  1259.     SETENV tz aaabbbccc                            (for tz) and
  1260.     SETENV aem_tz aaaaaaaaabbbbbccccccccc          (for aem_tz)
  1261.  
  1262. aaa, your local time zone abbreviation must always be present.  If you
  1263. don't know your abbreviation (or don't want it in the header), use "xxx".
  1264. If AEMail sees xxx it will assume that no abbreviation is present and it
  1265. will be left off the Date:  header
  1266.  
  1267. bbb is the time offset in hours from GMT.  Plus indicates that you are
  1268. west of GMT and minus indicates that you are east of GMT.  Acceptable
  1269. values are -12 to 24.  If you want to specify a half our time zone it can
  1270. be entered as hhmm.  If AEMail sees a value of 30 or above it assumes that
  1271. a half hour increment is being used.  In this case -1200 to 2400 are
  1272. acceptable.
  1273.  
  1274. If your time zone observes daylight savings time, ccc is the abbreviation
  1275. to use for daylight savings time.  If ccc is not present, no adjustment
  1276. will be made during the times of the year that daylight savings time is
  1277. observed.
  1278.  
  1279. The result of the SETENV command is only in effect while your computer is
  1280. on.  If you want to make the "tz"or "aem_tz" environmental variables
  1281. always present enter the one of the following AmigaDOS command after the
  1282. SETENV command:
  1283.  
  1284.     COPY ENV:tz ENVARC:tz                          (or)
  1285.     COPY ENV:aem_tz ENVARC:aem_tz
  1286.  
  1287. Using the "tz" or "aem_tz" environmental variables gives you more control
  1288. over which abbreviations will be used for your time zone.  However, the
  1289. locale.prefs file may be more useful for those that prefer the "point and
  1290. click" method of doing things.  To set the correct time zone for
  1291. locale.prefs, enter the Locale editor in your Prefs drawer.  You will see
  1292. a time zone map with which you can move the white strip indicating the
  1293. time zone on the map.  Click either to the left or right of the strip to
  1294. move the strip.  The correct time zone offset for standard time will be
  1295. shown at the top of the map.
  1296.  
  1297. Since the locale.prefs does not have any abbreviations, AEMail makes
  1298. certain assumptions as to what the abbreviation should be.  These
  1299. assumptions are as follows:
  1300.  
  1301. Time Zone Name           Standard    DST  -----------Time Zone-----------
  1302.                          Time             (in "locale")  (in email Date:)
  1303.  
  1304. Greenwich Mean Time      GMT*        BST       0              +0000
  1305.  
  1306. Atlantic Time            AST         ADT       4              -0400
  1307. Eastern Time (US)        EST         EDT       5              -0500
  1308. Central Time (US)        CST         CDT       6              -0600
  1309. Mountain Time (US)       MST         MDT       7              -0700
  1310. Pacific Time (US)        PST         PDT       8              -0800
  1311. Yukon Time               YST         YDT       9              -0900
  1312. Hawaiian Time            HST         ---      10              -1000
  1313.  
  1314. International Date Line  IDL         ---      12              -1200
  1315.  
  1316. --- indicates this time zone does not observe DST
  1317.  
  1318. *Note:  GMT (Greenwich Mean Time) is also known as UTC or Universal Time
  1319. Coordinated.
  1320.  
  1321. If you want to use a different abbreviation or control whether DST is used
  1322. or not, you should use the "tz" or "aem_tz" environmental variable.
  1323.  
  1324. DST in the United States and Canada begins on the first Sunday in April.
  1325.  
  1326. "Summer Time" in the United Kingdom and Europe begins on the last Sunday
  1327. in March.
  1328.  
  1329. Both DST and "Summer Time" end on the last Sunday in October.
  1330.  
  1331.                             IV. CONFIGURATION
  1332.  
  1333. The configuration of AEMail is provided by parameters presented as
  1334. Tool Types in the AEMail icon or by a Configuration Setup Window
  1335. that can be called up from within AEMail using the
  1336. "Project/Configuratio/Edit.." menu item.  All configuration items provided
  1337. by Tool Types can also be provided by the Configuration Setup Window with
  1338. the exception of the MAIL_DIR=, the CONFIG=, and the PASSPROTECT=
  1339. Tool Types.  These three Tool Types have special uses, as explained below,
  1340. that can not be duplicated by the Configuration Setup Window; but they are
  1341. set during the installation of AEMail.
  1342.  
  1343. You will also find that if you want to change your ARexx port name, that
  1344. can only be done with the AREXXPORT= Tool Type.  Adding this Tool Type must
  1345. be done manually, since it is not possible to do it with the Installation
  1346. script.
  1347.  
  1348. Certain configuration parameters can ONLY be provided by the Configuration
  1349. Setup Window.
  1350.  
  1351. Currently, setting the time zone that you are in is done outside the
  1352. AEMail environment.  To set the time zone for AEMail see "HANDLING OF TIME
  1353. ZONES IN AEMAIL" above.
  1354.  
  1355. If you are running AEMail from the shell or as a "mailto:" agent, it must
  1356. be either pre-configured with the S:aemail.cnfg file or you will
  1357. have to specify the config= parameter on the AEMail call line.  You can
  1358. specify an alternate configuration file (other than S:aemail.cnfg) by
  1359. using the config= parameter on the AEMail call line.  Also, the
  1360. configuration file you use must be present or AEMail will be unable to
  1361. find the mail directory.  Tool types used in a program's icon are not
  1362. available from the shell; however, a mail_dir= parameter is provided on
  1363. the shell call line to allow the mail directory to be specified.
  1364.  
  1365. The first thing AEMail does when it is activated is check to see that
  1366. certain configuration information has been provided either through Tool
  1367. Types or as contained in the AEMail configuration file.  The necessary
  1368. items are:
  1369.  
  1370.     POP3 UserID
  1371.     Password
  1372.     From Addr (your email address)
  1373.     POP Server
  1374.     SMTP Server
  1375.     Domain Name
  1376.     Edit Call
  1377.  
  1378.  
  1379. If any of these items are missing, the following requester will be
  1380. displayed:
  1381.  
  1382.     The following Configuration items are empty
  1383.  
  1384.     [list of empty items]
  1385.  
  1386.     They are required items!
  1387.  
  1388.  
  1389. The Edit Call item, if it is missing, will default to:
  1390.  
  1391.     C:ed %s
  1392.  
  1393. with the editor opening on the Workbench.  The only way the Edit Call can
  1394. appear in the list is if the General Parameters page of the Configuration
  1395. Setup Window had been entered and the Edit call field cleared.
  1396.  
  1397. If this requester is displayed, you will be given the following choices:
  1398.  
  1399.        [Configure AEMAIL now]               [Cancel AEMAIL]
  1400.  
  1401. If you were to click on [Cancel AEMAIL], AEMail will terminate.  You can
  1402. not proceed any further until you have entered these items with the
  1403. Configuration Setup Window or by providing them as Tool Types.
  1404.  
  1405. Clicking on the [Configure AEMAIL now] will bring up the Configuration
  1406. Setup Window which is described below following the description of the Tool
  1407. Types.
  1408.  
  1409. Also, if "Mail Directory" appears in the list of empty items, it means
  1410. that the the MAIL_DIR Tool Type has not been given.  Even though the mail
  1411. directory will be displayed on the Configuration Setup Window, there is no
  1412. way you can provide this information through the Configuration Setup
  1413. Window.  You will have to add the MAIL_DIR Tool Type.  If you use the
  1414. standard install script, this should never be necessary.
  1415.  
  1416. The three Tool Types, MAIL_DIR=, CONFIG=, and PASSPROTECT=YES have special
  1417. uses.  CONFIG= is used to specify the configuration file that AEMail is to
  1418. open with.  If AEMail is called from the shell, s:aemail.cnfg will be used
  1419. as the configuration file for the shell invocation of AEMail unless the
  1420. config= parameter is used in the shell call.  You must have executed
  1421. AEMail at least once from the workbench with the CONFIG= tool type
  1422. pointing to s:aemail.cnfg for this file to be created.
  1423.  
  1424. MAIL_DIR= is used to specify the mail directory that this user will use.
  1425. When the configuration file is first created, this directory will be
  1426. stored in that file and if AEMail is called from the shell without a
  1427. mail_dir= parameter in the call line the configuration file defaults to
  1428. the mail directory stored in s:aemail.cnfg.
  1429.  
  1430. PASSPROTECT=YES is used to password protect AEMail when you click on it's
  1431. icon.  Using this Tool Type will call up a requester as soon as you load
  1432. AEMail which will force you to enter the password that was configured for
  1433. that instance of the configuration file.  The PASSPROTECT=YES condition is
  1434. not stored in the configuration file but is only obtained from the Tool
  1435. Type and therefor is not effective when AEMail is called from the shell.
  1436.  
  1437. The Installation script will take care of providing all of the Tool Types
  1438. necessary so it will not be necessary to add them manually.
  1439.  
  1440. If you have two or more users of AEMail on the same system and you want
  1441. each user to have different locations for their mail files, you can
  1442. establish an alternate location for the mail directories.  To do this, you
  1443. will have to have two different AEMail Project icons with different names
  1444. if they are in the same directory.  You can still have only one AEMail
  1445. executable, however.
  1446.  
  1447. With AEMail 2.xx, all of the icons will have to be "Project" icons and
  1448. they will be automatically created by the Installation script.  It is
  1449. recommended that you use the Installation script to establish, update, or
  1450. add users.  Once you have installed the AEMail executables, the Install
  1451. script will give you the option of only configuring your users.
  1452.  
  1453. If you are updating from a previous version of AEMail, you will already
  1454. have a "tool" icon called "AEMail".  If you choose to, you can create an
  1455. icon with a different name for your primary user or leave the primary
  1456. user's icon as "AEMail".  If you choose to keep "AEMail" as your primary
  1457. user's icon, this icon will be changed to a Project icon.
  1458.  
  1459. If you want password protection (only available to registered AEMail
  1460. users) you should also add the Tool Type PASSPROTECT=YES through the
  1461. Installation script.  Do this for each user that you want to password
  1462. protect.  Password protection is not available if you call AEMail from the
  1463. shell.
  1464.  
  1465. Please Note:  The Project icon will also inherit the Tool Types from any
  1466. icon named "AEMail" even if it is only a Project icon; however, if there
  1467. is an identical Tool Type, the current Project icon's Tool Type will take
  1468. precedence.
  1469.  
  1470. WARNING:  If you are updating and you decide to use a different name for
  1471. the primary user's icon, the AEMail old Tool icon will remain.  Do not
  1472. delete this icon from the workbench after you have installed AEMail or you
  1473. will delete the AEMail executable along with it.  This is true even if the
  1474. icon has been changed to a Project icon.  If you are going to use a
  1475. different name, delete the AEMail icon BEFORE installing AEMail 2.xx.
  1476.  
  1477.                                 TOOL TYPES
  1478.  
  1479. Tool Types have been provided to initially provide certain Configuration
  1480. information when AEMail is first activated without the need to build the
  1481. Configuration information through the Configuration Setup Window.
  1482.  
  1483. To modify or delete any specific Tool Type, select the AEMail icon and
  1484. then select the "Information" item from the Workbench menu.  You will have
  1485. to select the appropiate Tool Type and modify it when it appears in the
  1486. string gadget below the Tool Type list.
  1487.  
  1488. The Installation script will handle Tool Type creation and updating
  1489. automatically with the exception of the AREXXPORT= and HELP= Tool Types.
  1490. If you need to add these Tool Types, it must be done manually.  There are
  1491. default actions that are automatically performed by AEMail if these Tool
  1492. Types are missing (see the desciption of each of these Tool Types to see
  1493. what the default action is).  Also, the FLDRFONT= and FLDRFONSZ= Tool
  1494. Types are not handled by the Installation script since the action of these
  1495. Tool Types, unlike AREXXPORT= and HELP=, can be performed by the Fonts
  1496. Page of the Configuration Setup Window.
  1497.  
  1498. The current Tool Types utilized by the program are:
  1499.  
  1500. INTERLACE=YES
  1501.  
  1502. This Tool Type is now obsolete, and, if used, will have no effect.  It was
  1503. used to open the AEMail Public Screen (AEMAIL-1) in hires, interlace mode.
  1504. AEMail has been changed so that initially it will open in the same screen
  1505. mode as the Workbench screen.
  1506.  
  1507. You can actually have more control over the Screen Mode you desire by
  1508. selecting the [Set Screen Mode] button in the AEMail Configuration:
  1509. General Parameters configuration display.
  1510.  
  1511. MAIL_DIR=directory-path
  1512.  
  1513. This Tool Type is required to assign your mail directory.  This is a
  1514. required Tool Type and CAN NOT be provided with the Configuration Setup
  1515. Window.
  1516.  
  1517. The Installation script automatically handles providing this Tool Type.
  1518.  
  1519.  
  1520. CONFIG=configuration-file
  1521.  
  1522. If you do not care to use the standard s:aemail.cnfg file for your
  1523. configuration data, but want a file named something else or in a different
  1524. location, you can use this tool type.  When AEMail opens it will look here
  1525. for the configuration file.  YOU MUST PRECEDE THE FILE NAME WITH THE FULL
  1526. PATH NAME.  This parameter CAN NOT be provided with the Configuration
  1527. Setup Window, although the initial file can be created, saved, and edited from
  1528. the "Project/Configuration" menu.  (DEFAULTS TO s:aemail.cnfg)
  1529.  
  1530. This Tool Type is automatically created by the Installation script.
  1531.  
  1532.  
  1533. MAILCAP_DIR=directory-path
  1534.  
  1535. This Tool Type is now obsolete.  The mailcap file will always reside in
  1536. the mail directory for any particular user.
  1537.  
  1538. The mailcap file must be called "mailcap".  Since the mailcap file follows
  1539. a standard format dictated by the internet (RFC 1524), you can use the
  1540. same mailcap file used by another process.  The Installation script will
  1541. handle copying this mailcap to your mail directory if you install at the
  1542. expert level.
  1543.  
  1544. You can change the contents of the mailcap file with the Viewer Page of
  1545. the Configuration Setup Window.
  1546.  
  1547.  
  1548. USERID=UserId
  1549.  
  1550. Enter your POP3 UserId for signing onto your POP Server on your Internet
  1551. provider (ISP).  This may be the same as the one initially used to sign
  1552. into your ISP.  It is also very possibly (but not always) the part of your
  1553. email address that precedes the @ sign.  Check with your ISP for what
  1554. should be used.
  1555.  
  1556. Example: my UserId is "jzachar" so I would enter
  1557.  
  1558.     USERID=jzachar
  1559.  
  1560. for this Tool Type.  THIS IS A REQUIRED PARAMETER, but it can be provided
  1561. with the Configuration Setup Window.
  1562.  
  1563.  
  1564. PASSWRD=your_password
  1565.  
  1566. Enter the password required for signing onto your POP3 server.  This may
  1567. or not be the same as that used to sign onto your Internet provider.  THIS
  1568. IS A REQUIRED PARAMETER, but it can be provided with the Configuration
  1569. Setup Window.
  1570.  
  1571. SPECIAL NOTE:  if the password is provided by a Tool Type it can be read
  1572. by anyone that performs an "Information" on the AEMail icon.  If you
  1573. provide the password through the Configuration Setup Window, it can not be seen.
  1574.  
  1575.  
  1576. PASSPROTECT=YES (registered users only)
  1577.  
  1578. Use this Tool Type if you want to password protect your mail directory.
  1579. This will call up a special password window when you first load AEMail
  1580. which will require you to enter your password before you procede.  You
  1581. will be given three chances to enter the correct password.  If the
  1582. password fails validation after the third try, AEMail will terminate.
  1583. This Tool Type is ignored for unregistered users.
  1584.  
  1585. The Password that is used is the one required for signing onto your POP3
  1586. server (see above).
  1587.  
  1588. DOMAIN=Domain_Name
  1589.  
  1590. Enter the Domain name used by your Internet provider's SMTP server.  It
  1591. very possibly is the same as the Domain part of your email address (the
  1592. part following the @ sign)
  1593.  
  1594. Example:  my Internet provider's domain name is "calweb.com" so I would
  1595. enter
  1596.  
  1597.     DOMAIN=calweb.com
  1598.  
  1599. for this Tool Type.  THIS IS A REQUIRED PARAMETER, but it can be provided
  1600. with the Configuration Setup Window.
  1601.  
  1602.  
  1603. FROM=your_email_address
  1604.  
  1605. Enter your FULL email address (i.e.  user@domain).  This is email address
  1606. that you are known by on the Internet.
  1607.  
  1608. Example:  my email address is "jzachar@calweb.com" so I would enter
  1609.  
  1610.     FROM=jzachar@calweb.com
  1611.  
  1612. for this tool type.  THIS IS A REQUIRED PARAMETER, but it can be provided
  1613. with the Identity Page of the Configuration Setup Window.  If it is
  1614. missing it defaults to UserID@Domain.  This default action may NOT be
  1615. correct for your situation, so be sure to change it if required to.
  1616.  
  1617.  
  1618. REALNAME=your_real_name
  1619.  
  1620. Enter your full name.  Example:
  1621.  
  1622.     REALNAME=John Zacharias
  1623.  
  1624. This is an OPTIONAL parameter, but if it is omitted your full name will
  1625. NOT be provided in the FROM:  address of any messages you send unless you
  1626. add it yourself when you compose a message.  This parameter can also be
  1627. provided with the Identity page of the Configuration Setup Window.
  1628.  
  1629.  
  1630. REPLYTO=reply-email-address
  1631.  
  1632. This is the email address that you want all replies directed to.  This may
  1633. be the same as your FROM email address or it can be a different address if
  1634. you want replies sent somewhere else.  This is an OPTIONAL parameter and
  1635. can also be provided with the Identity page of the Configuration Setup
  1636. Window.
  1637.  
  1638. The standard REPLY-TO address provided here can also be modified each time
  1639. you compose a message to send.
  1640.  
  1641.  
  1642. ORGANIZATION=organization-name
  1643.  
  1644. This parameter is OPTIONAL and, if present, will provide an Organization:
  1645. header for any message that you compose and send.  This parameter can also
  1646. be provided with the Identity page of the Configuration Setup Window.
  1647.  
  1648.  
  1649. POP_SERVER=your_POP_host
  1650.  
  1651. Enter the name of your POP host.  This sometimes is "pop." or "mail."
  1652. prepended to your Domain name.  As an example, mine is "pop.calweb.com" so
  1653. I would enter
  1654.  
  1655.     POP_SERVER=pop.calweb.com
  1656.  
  1657. If this parameter is omitted, "pop.[domain-name]" will be generated as
  1658. your POP_SERVER name provided a domain name has been specified.  If your's
  1659. uses a different name you should use this Tool Type or change it with the
  1660. Configuration Setup Window.
  1661.  
  1662. This parameter can also be provided by the Identity page of the
  1663. Configuration Setup Window.
  1664.  
  1665.  
  1666. SMTP_SERVER=your_SMTP_host
  1667.  
  1668. Enter the name of your SMTP host.  This sometimes is "smtp."
  1669. or "mail." prepended to your Domain name.  As an example,
  1670. mine is "smtp.calweb.com" so I would enter
  1671.  
  1672.     SMTP_SERVER=smtp.calweb.com
  1673.  
  1674. If this parameter is omitted, "smtp.[domain-name]" will be generated as
  1675. your SMTP_SERVER name provided a domain name has been specified.  If
  1676. your's uses a differnt name you should use this Tool Type or change it
  1677. with the Configuration Setup Window.
  1678.  
  1679. This parameter can also be provided by the Identity page of the
  1680. Configuration Setup Window.
  1681.  
  1682.  
  1683. EDITOR=call_line_for_your_editor
  1684.  
  1685. Enter the full call parameter required to activate your editor from the
  1686. shell.  Use "%s" where you would place the file name.
  1687.  
  1688. You are no longer restricted to an editor call that does not remain in
  1689. control when you call it as you were with previous versions of AEMail.  In
  1690. other words, a direct call to CygnusEd (CED) is acceptable.
  1691.  
  1692. If your editor opens on the workbench screen rather than a screen of its
  1693. own, you should prepend "WB;" in front of your editor call.  As an
  1694. example, the standard AmigaDos ED program always opens on the workbench
  1695. screen.  An example edit call for the Amiga ED would be as follows:
  1696.  
  1697.     EDITOR=WB;c:ed %s WINDOW raw:0/0/640/400/AEMailCompose
  1698.  
  1699. The window statement in the above call is used to create a full screen
  1700. window with an interlaced display.
  1701.  
  1702. If you are not using an interlaced display you can remove the WINDOW
  1703. parameter or change it to raw:0/0/640/200/AEMailCompose.  You can, of
  1704. course, make other changes to the window parameters if you desire.
  1705.  
  1706. If you are using the Amiga ED you should probably also remove or rename
  1707. the ED-Startup file in the S:  directory so that you will have a full set
  1708. of ED menus.
  1709.  
  1710. If this Tool Type is missing, the following call is the default editor
  1711. call:
  1712.  
  1713.     EDITOR=WB;c:ed %s
  1714.  
  1715. This defaults to using the Amiga Ed program for your editor.
  1716.  
  1717. The specification for your editor call can also be provided by the
  1718. General Parameters page of the Configuration Setup Window.  A convenient
  1719. check mark item is provided in the Configuration Setup Window to open the
  1720. editor on the Workbench screen.
  1721.  
  1722.  
  1723. TCPLOG=name_of_log_file
  1724.  
  1725. Enter the full path, including the file name, of your TCP logging file.
  1726. If this parameter is omitted, it defaults to "tcplog" in the directory
  1727. AEMail is loaded from.
  1728.  
  1729. This parameter does not start TCP logging, it only establishes the name of
  1730. the TCPLOG file.  Logging can be started or stopped at any time by a menu
  1731. item (see Section VII.  AEMAIL MENUS - TCP Logging File under the TCP/IP
  1732. menu).  The Logging file can be active when AEMail is started through a
  1733. parameter in a Configuration Setup Window item.
  1734.  
  1735. When TCP logging is active, all sends and receives over the TCP/IP
  1736. connection are recorded to this file.  Each time an AEMail session is
  1737. started and logging is active, data is appended to this file.  As a result
  1738. this file can become quite large.  IT IS THE USER'S RESPONSIBILITY TO
  1739. PERIODICALLY PURGE (DELETE) THIS FILE.  A menu item is provided to perform
  1740. this purge and another item to display the log file with your editor from
  1741. within AEMail.
  1742.  
  1743. NOTE:  When there is a need to report a problem, especially with your
  1744. TCP/IP connection, the TCP Logging file should be set active and a copy of
  1745. the resultant file provided with any feedback on the program activity (see
  1746. Section XI, Bug Reports & Suggestions).  The file can be sent as an
  1747. attachment to any message that you send to AEMail.  You probably should
  1748. compress the file with LHA before attaching it as an "Applicatio/Octet
  1749. Stream" content type with "encoded binary" encoding.
  1750.  
  1751. I have discovered that this file comes in handy when analysing problems
  1752. with your Internet provider since it time stamps all entries to the
  1753. nearest second.
  1754.  
  1755. This parameter can also be provided by the Default Path Parameters
  1756. page of the Configuration Setup Window.
  1757.  
  1758.  
  1759. DELETEMAIL=YES
  1760.  
  1761. This Tool Type sets the initial value of the "Delete Host Mail" menu item
  1762. under the RETRIEVE MESSAGES menu.  If this Tool Type is entered, the
  1763. "Delete Host Mail" menu item will be initially checked.  See the "Delete
  1764. Host Mail" item under section VII.  AEMAIL MENUS below.
  1765.  
  1766. This parameter can also be set by the General Parameters page of the
  1767. Configuration Setup Window or the DELETEMAIL flag can be set with the
  1768. "Delete Host Mail" menu item and its state can be saved in the
  1769. configuration file by selecting the "PROJECT/CONFIGURATION/SAVE" menu
  1770. item.
  1771.  
  1772.  
  1773. FULLHEADER=YES
  1774.  
  1775. This Tool Type sets the initial value of the "Display Full Header" menu
  1776. item under the MESSAGES menu.  If this Tool Type is entered, the "Display
  1777. Full Header" menu item will be initially checked.  See the "Display Full
  1778. Header" item under section VII.  AEMAIL MENUS below.
  1779.  
  1780. This parameter can also be set by the General Parameters page of the
  1781. Configuration Setup Window or the FULLHEADER flag can be set with the
  1782. "Display Full Header" menu item and its state can be saved in the
  1783. configuration file by selecting the "PROJECT/CONFIGURATION/SAVE" menu
  1784. item.
  1785.  
  1786.  
  1787. STRIPDUPS=YES
  1788.  
  1789. This Tool Type sets the initial value of the "Exclude Duplicate Messages"
  1790. menu item under the RETRIEVE MESSAGES menu.  If this Tool Type is entered,
  1791. the "Exclude Duplicate Messages" menu item will be initially checked.  See
  1792. the "Exclude Duplicate Messages" item under section VII.  AEMAIL MENUS
  1793. below.
  1794.  
  1795. This parameter can also be set by the General Parameters page of the
  1796. Configuration Setup Window or the STRIPDUPS flag can be set with the
  1797. "Exclude Duplicate Messages" menu item and its state can be saved in the
  1798. configuration file by selecting the "PROJECT/CONFIGURATION/SAVE" menu
  1799. item.
  1800.  
  1801.  
  1802. HDRINREPLY=YES
  1803.  
  1804. This Tool Type sets the initial value of the "Include Header in Response"
  1805. menu item under the MESSAGES menu.  If this Tool Type is entered, the
  1806. "Include Header in Response" menu item will be initially checked.  See
  1807. the "Include Header in Response" item under section VII.  AEMAIL MENUS
  1808. below.
  1809.  
  1810. This parameter can also be set by the General Parameters page of the
  1811. Configuration Setup Window or the HDRINREPLY flag can be set with the
  1812. "Include Header in Response" menu item and its state can be saved in the
  1813. configuration file by selecting the "PROJECT/CONFIGURATION/SAVE" menu
  1814. item.
  1815.  
  1816.  
  1817. STARTNET=call_line_for_your_startnet_script
  1818.  
  1819. This Tool Type is used to specify the call line for your script that
  1820. starts up your TCP/IP stack.  If you are using AmiTCP, this is normally
  1821. the file "startnet" in the AMITCP:bin directory.  If you are using Miami,
  1822. an AREXX script has been provided with the AEMail archive called
  1823. "startnet.miami" and it is located in the AEMail program directory.
  1824.  
  1825. A full path name to that script must be entered.  If the script is an
  1826. AREXX script it should be preceded with "rx " (a space is between the rx
  1827. and the script name).  The standard AmiTCP startnet script is NOT an AREXX
  1828. script even though it uses AREXX commands.  It is an AmigaDOS script.  The
  1829. Miami script, on the other hand, is an AREXX script.
  1830.  
  1831. If you do not use the STARTNET Tool Type, AEMail assumes that you do not
  1832. have a script.  If you activate the "Start Net" item in the TCP/IP menu
  1833. and you don't have a startnet script, AEMail's action is to iconify and
  1834. allow you to manually start your TCP/IP stack.  Connect using the method
  1835. prescribed by your TCP/IP stack.  When you un-iconify AEMail, AEMail will
  1836. immediately check to see if any mail is present on your POP server.
  1837.  
  1838. If you are using a TCP/IP stack that can't use a script (such as
  1839. TermiteTCP) or you have no script to make connection to your Internet
  1840. provider, then this Tool Type should not be used.  Then if you select the
  1841. StartNet menu item, the system will automatically iconify AEMail and
  1842. present the Workbench screen.
  1843.  
  1844. Since AmiTCP Demo Version 4.0 puts up a requester on the workbench screen
  1845. that must be responded to, AEMail will automatically switch to the
  1846. Workbench screen before calling this script.  Although the Miami script
  1847. does not require manual intervention, the default action is to also switch
  1848. to the Workbench screen since this allows you to see the action of the
  1849. dialer.  When the connection has been made using Miami, the screen will
  1850. automatically switch back to the AEMail screen.
  1851.  
  1852. The Start Net script can also be set by the TCP/IP page of the
  1853. Configuration Setup Window.  The Configuration Setup Window will also
  1854. allow you to set whether or not the system switches to the Workbench
  1855. screen when the Start Net script is executed.
  1856.  
  1857. Note:  Check your startnet script to be sure that full path names are
  1858. specified.  If you are using the standard AmiTCP startnet script, that
  1859. script will not be executed from the Amitcp:bin directory if AEMail is in
  1860. another directory.  Therefor, you should verify that Amitcp:bin/ is
  1861. prepended to all calls to functions within the AmiTCP/bin directory within
  1862. the script.  Pay particular attention to the "online" call - it should be
  1863. AmiTCP:bin/online.
  1864.  
  1865.  
  1866. STOPNET=call_line_for_your_stopnet_script
  1867.  
  1868. This Tool Type is used to specify the call line for your script that
  1869. terminates your TCP/IP connection.  If you are using AmiTCP, this is
  1870. normally the file "stopnet" in the AMITCP:bin directory.  If you are using
  1871. Miami, an AREXX script has been provided with the AEMail archive called
  1872. "stopnet.miami" and it is located in the AEMail program directory.
  1873.  
  1874. A full path name to that script must be entered.  If the script is an
  1875. AREXX script it should be preceded with "rx " (a space between the rx and
  1876. the script name).  The standard AmiTCP startnet script is NOT an AREXX
  1877. script even though it uses AREXX commands.  It is an AmigaDOS script.  The
  1878. Miami script, on the other hand, is an AREXX script.
  1879.  
  1880. If you do not use the STOPNET Tool Type, AEMail assumes that you you do
  1881. not have a script.  If you activate the "Stop Net" item in the TCP/IP menu
  1882. and you don't have a stopnet script, AEMail's action is to iconify and
  1883. allow you to manually stop your TCP/IP stack.  You can then disconnect
  1884. using the method prescribed by your TCP/IP stack.  When you un-iconify
  1885. AEMail, AEMail will test to see if you are, in fact, disconnected.
  1886.  
  1887. If you are using a TCP/IP stack that can't use a script (such as
  1888. TermiteTCP) or you have no script to terminate your connection to your
  1889. Internet provider, then this Tool Type should not be used.  Then if you
  1890. select the Stop Net menu item, the system will automatically iconify
  1891. AEMail and present the Workbench screen.
  1892.  
  1893. The Stop Net script can also be set by the TCP/IP page of the
  1894. Configuration Setup Window.  The Configuration Setup Window will also
  1895. allow you to set whether or not the system switches to the Workbench
  1896. screen when the Stop Net script is executed.  Since terminating your
  1897. connection with a script usually does not require any visual interaction,
  1898. the default action is to NOT switch to the Workbench screen.
  1899.  
  1900. Note:  Check your stopnet script to be sure that full path names are
  1901. specified.  If you are using the standard AmiTCP stopnet script, that
  1902. script will not be executed from the Amitcp:bin directory if AEMail is in
  1903. another directory.  Therefor, you should verify that Amitcp:bin/ is
  1904. prepended to all calls to functions within the AmiTCP/bin directory within
  1905. the script.  Pay particular attention to the "offline" call - it should be
  1906. AmiTCP:bin/offline.
  1907.  
  1908.  
  1909. AUTOCONNECT=YES
  1910.  
  1911. When AEMail is first activated it attempts to determine if you are
  1912. connected to your Internet provider.  If you are not and this Tool Type is
  1913. present, AEMail will automatically run your StartNet script.
  1914.  
  1915. Before activating this Tool Type, you should check to see if AEMail can
  1916. activate your TCP/IP stack properly using the StartNet menu item.  If
  1917. there are any problems with your StartNet activation they will show up at
  1918. this time rather than constantly every time you try to activate AEMail.
  1919.  
  1920. WARNING:  You should not use this Tool Type if a StartNet script is not
  1921. present for your TCP/IP stack.  You should activate your TCP/IP stack
  1922. manually before you start AEMail.
  1923.  
  1924. You can also set the AUTOCONNECT flag with the TCP/IP Parameters page
  1925. of the Configuration Setup Window.
  1926.  
  1927.  
  1928. FLDRFONT=fontname
  1929.  
  1930. This allows the user to specify their own font for the folder strip.
  1931. Since the size of the folders in the folder strip is constrained by the
  1932. size of the font that you use, you can specify a different font and font
  1933. size (see FLDRFONTSZ= below) to reduce the size of the folder strip.  If
  1934. not specified the folder font will default to the standard Topaz 8 font.
  1935. When you enter the font name it is entered WITHOUT the .font suffix and it
  1936. must be found in your FONTS: directory.
  1937.  
  1938. If you use FLDRFONT= without FLDRFONTSZ=, the resulting font will be the
  1939. one you specify at the 8 size.  If no such size exists in your FONTS:
  1940. directory, it will be computed.  This can sometimes be unsatisfactory.
  1941.  
  1942. This parameter can also be set with the Fonts page of the Configuration
  1943. Setup Window.
  1944.  
  1945.  
  1946. FLDRFONTSZ=fontsize
  1947.  
  1948. This Tool Type is used in conjuction with the FLDRFONT= Tool Type
  1949. described above.  These two Tool Types allow the user to specify their own
  1950. font and font size for the folder strip.  Since the size of the folders in
  1951. the folder strip is constrained by the size of the font that you use, you
  1952. can specify a different font and font size to reduce the size of the
  1953. folder strip.  If not specified the folder font will default to the
  1954. standard Topaz 8 font.
  1955.  
  1956. If you use FLDRFONTSZ= without FLDRFONT=, the resulting font will be Topaz
  1957. with a computed font size corresponding to this parameter
  1958.  
  1959. This parameter can also be set with the Fonts page of the Configuration
  1960. Setup Window.
  1961.  
  1962.  
  1963. AREXXPORT=portname
  1964.  
  1965. This Tool Type will allow you to change the default ARexx Port Name.  By
  1966. default the ARexx Port Name is "AEMAIL1".  A "1" will be appended to
  1967. whatever port name you specify unless that port is already active in your
  1968. system.  In this event a number next in sequence will be appended to the
  1969. port name.
  1970.  
  1971. The ARexx Port Name will be shown in the About message obtained with the
  1972. "About" item under the Project Menu.
  1973.  
  1974. This parameter can only be provided with a Tool Type.
  1975.  
  1976.  
  1977. HELP=full-path-name-to-"AEMail.guide"-file
  1978.  
  1979. This Tool Type will allow you to change the default AEMail.guide path
  1980. name.  You should include the file name of the guide file.  By default the
  1981. "AEMail.guide" path name is "AEMail2:documentation/AEMail.guide".  If you
  1982. are using the default path name you do not have to use this tool type.
  1983.  
  1984. If AEMail can not find the help file, it will display a requester like
  1985. this when you first load AEMail:
  1986.  
  1987.                      Error: (AG) Can't Open database!
  1988.  
  1989.                                 [Continue]
  1990.  
  1991. You can continue without the guide file, but the [Help] key will be
  1992. deactivated.
  1993.  
  1994. This parameter can only be provided with a Tool Type.
  1995.  
  1996.                         CONFIGURATION SETUP WINDOW
  1997.  
  1998. The Configuration setup window is displayed in the center of the AEMail
  1999. screen whenever you click on either the [Configure AEMAIL now] button or
  2000. when you select the "Project/Configuration/Edit" menu item.  The
  2001. configuration setup is divided into seven pages with the page name shown
  2002. with a tab at the top of the page area.  When you click on any one tab,
  2003. that tab will stand out and become bold and the appropriate page will be
  2004. displayed.
  2005.  
  2006. The seven pages are:
  2007.  
  2008.     Identity
  2009.     TCP/IP
  2010.     Paths
  2011.     Viewer
  2012.     ARexx
  2013.     Fonts
  2014.     General
  2015.  
  2016. When the Configuration Setup Window first opens, the Identity page will be
  2017. displayed and the first string gadget ("POP3 User ID") will be activated.
  2018. However, when you bring up another page by clicking into the tab for that
  2019. page (or using the tab hot key), the first string gadget on that page will
  2020. not be activated.  You will have to click into one of the string gadgets
  2021. to activate it.  From then on the tab and shift tab keys will work
  2022. correctly for going between string gadgets.
  2023.  
  2024. You will also have to re-activate the string gadgets after pressing the
  2025. [Help] key.
  2026.  
  2027. You will notice that several of the gadgets have underlined characters.
  2028. These are hot keys that you can use to activate the gadget rather than
  2029. clicking on the gadget.  If a string gadget is currently activated, the
  2030. hot keys will not work since it will be interpreted as a key being entered
  2031. into the string.  You can always hit return when you have finished
  2032. entering something in the string gadget and the hot keys will now be
  2033. available.
  2034.  
  2035. You can also use the tab key to go the next string gadget while a string
  2036. gadget is active (indicated by the cursor in the gadget).  Shift tab will
  2037. go to the previous string gadget.  Besides the normal editing keys used
  2038. for strings, each string can also copy to the clipboard (RIGHT AMIGA 'c'),
  2039. copy from the keyboard (RIGHT AMIGA 'v'), and change clipboard units
  2040. (RIGHT AMIGA 'u' and 'U') (see also "Editing String Entry Gadgets" under
  2041. Section V USING AEMAIL).
  2042.  
  2043. Additional editing keys have also been provided just for the Configuration
  2044. Setup Window string gadgets.  This are:  RIGHT AMIGA 'd' which will bring
  2045. the default entry into the string; RIGHT AMIGA 'f' which will bring up the
  2046. file requester for those strings that have a file requester associated
  2047. with them; and RIGHT AMIGA 'p' for the "POP3 UserId" string gadget on the
  2048. Identity page to bring up the "Set Password" requester.
  2049.  
  2050. At the bottom of the Configuration Setup Window is a row of buttons as
  2051. follows:
  2052.  
  2053.  
  2054. [      Use      ] [      Save      ] [    Save As    ] [     Cancel     ]
  2055.  
  2056.  
  2057. Clicking on any one of these buttons (or using the appropriate hot key)
  2058. will perform the requested action, regardless of which page you are on,
  2059. and return you to the current AEMail window.
  2060.  
  2061. If you want the configuration information to apply only to the current
  2062. AEMail session select [USE].  If you want to make the configuration
  2063. permanent, select [SAVE].  This will cause a new configuration file to be
  2064. written over the current active configuration file.
  2065.  
  2066. The configuration file is the file specified in the CONFIG= tool type for
  2067. the Project icon you selected to load AEMail.  However, if you opened
  2068. another configuration file with the "Project/Configuration/Open..." menu
  2069. item, that configuration file will be the current active one.
  2070.  
  2071. The [SAVE AS] button does the same as [SAVE] except that a file requester
  2072. will be displayed that will allow you to rename and place the
  2073. configuration file anywhere you wish.  WARNING:  when you use the [SAVE
  2074. AS] button, AEMail assumes that that file is now your active configuration
  2075. file and any saves occuring after that will be to that file.
  2076.  
  2077. To return to the base configuration (the CONFIG= file), use the
  2078. "Project/Configuration/Restore Default" menu item.
  2079.  
  2080. WARNING:  Any Open or Save As operations are made to what is termed
  2081. "shared" configurations.  These are configurations that generally DO NOT
  2082. HAVE a project icon and share the same mail directory (each use the same
  2083. folder setup).  You should not open a configuration that has a different
  2084. mail directory.
  2085.  
  2086. When AEMail opens it will always use the base configuration file specified
  2087. in the CONFIG= Tool Type.  To change this specification, you will have to
  2088. do this manually or use the Installation script which handles setting the
  2089. CONFIG= Tool Type automatically.
  2090.  
  2091. [CANCEL] will abort the operation without making any changes to the
  2092. configuration information.
  2093.  
  2094. The [USE], [SAVE], [SAVE AS] or [CANCEL] buttons are active no matter
  2095. which configuration page is currently active.  When the Configuration
  2096. Setup Window is first activated, the Identity page will be active.
  2097.  
  2098. Before exiting from the Configuration Setup Window with [USE], [SAVE], or
  2099. [SAVE AS] the required configuration parameters must be present.  If not,
  2100. the following requester will be displayed:
  2101.  
  2102.     The following Configuration items are empty
  2103.  
  2104.     [list of empty items]
  2105.  
  2106.     They are required items!
  2107.  
  2108. This is the same requester that is displayed when AEMail is started
  2109. without these parameters being provided.  Your choices with this requester
  2110. are:
  2111.  
  2112.     [Reenter Configuration Data]   [Cancel Configuration Request]
  2113.  
  2114. Clicking on the [Cancel Configuraion Request] will act the same as if you
  2115. clicked on [CANCEL] in the main Configuration Setup Window.  In this event
  2116. your "old" configuration data will still be active and if you did not have
  2117. the required parameters in the first place, you will not be able to do
  2118. anything but enter the data or exit from AEMail.
  2119.  
  2120. The one exception to the "old" configuration remaining the same is with
  2121. the .headers file.  This is always updated no matter which button is
  2122. pressed.
  2123.  
  2124.  
  2125.                               Identity Page
  2126.                               -------------
  2127.  
  2128. The Identity page appears as follows:
  2129.  
  2130. =========================================================================
  2131. [o] AEMail Configuration Setup
  2132. -------------------------------------------------------------------------
  2133.   ----------
  2134.  | Identity |___________________________________________________________
  2135. |                                                                       |
  2136. |         POP3 UserID: [                  ][CLR][DEFAULT] [Set Password]|
  2137. |                                                                       |
  2138. |From (email) Address: [                                 ][CLR][DEFAULT]|
  2139. |                                                                       |
  2140. |    Reply To Address: [                                 ][CLR]{DEFAULT]|
  2141. |                                                                       |
  2142. |           Real Name: [                                 ][CLR][DEFAULT]|
  2143. |                                                                       |
  2144. |        Organization: [                                 ][CLR][DEFAULT]|
  2145. |                                                                       |
  2146. |          POP Server: [                                 ][CLR][DEFAULT]|
  2147. |                                                                       |
  2148. |         SMTP Server: [                                 ][CLR][DEFAULT]|
  2149. |                                                                       |
  2150. |         Domain Name: [                                 ][CLR][DEFAULT]|
  2151. |_______________________________________________________________________|
  2152.  
  2153. [      Use      ] [      Save      ] [    Save As    ] [     Cancel     ]
  2154.  
  2155. =========================================================================
  2156.  
  2157. When this page is first called up, values from the Tool Types or the
  2158. current configuration file (which ever takes precedence) will be displayed
  2159. in each of the string gadgets.
  2160.  
  2161. Appropriate information can be entered into each of the string gadgets. Up
  2162. to 99 characters can be entered in each of the string gadgets.
  2163.  
  2164. The buttons to the side of each string gadget perform the following
  2165. actions:
  2166.  
  2167.     [CLR] will cause the string gadget to be cleared.
  2168.           (string edit key: RIGHT AMIGA 'x')
  2169.  
  2170.     [DEFAULT] (string edit key:  RIGHT AMIGA 'd') will cause default
  2171.         information to be loaded into the string gadgets as follows:
  2172.  
  2173.             POP3 UserID: information from the USERID= Tool Type if
  2174.                 present; otherwise it will use information from the
  2175.                 USER environmental variable or by parsing the
  2176.                 ttcp-email-address environmental variable created
  2177.                 by Termite-TCP.
  2178.             Domain Name: Information from the DOMAIN= Tool Type if
  2179.                 present; otherwise it will use information from either
  2180.                 the DOMAIN or DOMAINNAME environmental variable or
  2181.                 by parsing the ttcp-email-address environmental
  2182.                 variable created by Termite-TCP.
  2183.             From Address: information from the FROM= Tool Type if
  2184.                 present; otherwise, if a Domain Name is present, it
  2185.                 will be the combination UserID@DomainName.
  2186.             Reply To Address: information from the REPLYTO=
  2187.                 Tool Type or, if missing, the From Address.
  2188.             Real Name: information from the REALNAME= Tool Type if
  2189.                 present; otherwise from the NAME environmental
  2190.                 variable.
  2191.             Organization: information from the ORGANIZATION= Tool
  2192.                 Type.
  2193.             POP Server: information from the POP_SERVER= Tool Type
  2194.                 if present; otherwise , if a Domain Name is present,
  2195.                 this will be the domain name with 'pop.' prepended
  2196.                 to it.
  2197.             SMTP Server:  Information from the SMTP_SERVER= Tool
  2198.                 Type if present; otherwise, if a Domain Name is
  2199.                 present, this will be the domain name with 'smtp.'
  2200.                 prepended to it.
  2201.  
  2202.         The environmental variables indicated above are only available
  2203.         if your TCP/IP software has been loaded before calling AEMail.
  2204.         The TCP/IP stack doesn't have to be running (i.e., on line),
  2205.         but it must be loaded.  If the default is missing, nothing
  2206.         is loaded into the corresponding string gadget.
  2207.  
  2208. The [SET PASSWORD] button gadget will bring up a special window which will
  2209. allow you to set or change your password.  When you are entering your POP3
  2210. UserID you can also use RIGHT AMIGA 'p' to call up this window.
  2211.  
  2212. The [SET PASSWORD] window looks like the following:
  2213.  
  2214.                 |========================================|
  2215.                 |0|Enter Password                        |
  2216.                 |----------------------------------------|
  2217.                 |                                        |
  2218.                 |     Enter your new password below      |
  2219.                 |                                        |
  2220.                 |  [                                  ]  |
  2221.                 |                                        |
  2222.                 |                                        |
  2223.                 |                                        |
  2224.                 |  [START OVER]            [  CANCEL  ]  |
  2225.                 |________________________________________|
  2226.  
  2227.  
  2228. The string gadget will be automatically activated when the window is
  2229. displayed.  You can type in your new password, but for each character you
  2230. type an * will appear.  You must hit return when you finish
  2231. entering your password.  After hitting return, the heading:
  2232.  
  2233.                        "Enter your password below"
  2234.  
  2235. will be replaced by the following heading:
  2236.  
  2237.                 "For verification, re-enter your password"
  2238.  
  2239. You must re-enter your password and, when you hit return, if the
  2240. re-entered password matches the first password, the password window will
  2241. close.  The new password will not take effect until you hit the [USE],
  2242. [SAVE] or [SAVE TO] buttons at the bottom of the Configuration Setup
  2243. Window.  If you hit the [CANCEL] button at the bottom of the Setup window
  2244. even though the new password has been accepted, the new password will not
  2245. be used.
  2246.  
  2247. If the re-entered password does not match, the following will appear below
  2248. the password entry string gadget:
  2249.  
  2250.                        Password failed Validation!
  2251.  
  2252. and the "Enter your password below" heading will re-appear.
  2253.  
  2254. If at any time you want to start over with entering the new password, you
  2255. can click on the [START OVER] gadget.  If you want to cancel the password
  2256. entry process you can either click on the close gadget at the top left of
  2257. the window or on the [CANCEL] gadget in the window.
  2258.  
  2259. Only 30 characters can be entered into the password string gadget.
  2260.  
  2261.  
  2262.                                TCP/IP Page
  2263.                                -----------
  2264.  
  2265. The TCP/IP page appears as follows:
  2266.  
  2267. =========================================================================
  2268. [o] AEMail Configuration Setup
  2269. -------------------------------------------------------------------------
  2270.              --------
  2271.  ___________| TCP/IP |__________________________________________________
  2272. |                                                                       |
  2273. |Start Net Call: [                                  ][|=|][CLR][DEFAULT]|
  2274. |                                                                       |
  2275. |                [ ] Start Net Opens on the Workbench [ ] ARexx Command |
  2276. |                                                                       |
  2277. |                                                                       |
  2278. | Stop Net Call: [                                  ][|=|][CLR][DEFAULT]|
  2279. |                                                                       |
  2280. |                [ ] Stop Net Opens on the Workbench  [ ] ARexx Command |
  2281. |                                                                       |
  2282. | [ ] Automatic connection to Internet on AEMail Start Up               |
  2283. | [ ] Display disconnect check on AEMail exit                           |
  2284. |                                                                       |
  2285. |Disable Queued Mail Check [] on Internet connection   [] at AEMail exit|
  2286. |   Disable New Mail Check [] on Internet connection   [] at AEMail exit|
  2287. |                                                                       |
  2288. |Check for new mail every [  ]/| minutes                                |
  2289. |_______________________________________________________________________|
  2290.  
  2291. [      Use      ] [      Save      ] [    Save As    ] [     Cancel     ]
  2292.  
  2293. ==========================================================================
  2294.  
  2295. The "Start Net Call" and "Stop Net Call" are required if you are going to
  2296. start up or stop your TCP/IP connection from within AEMail with a script.
  2297. If you are using AmiTCP, this is normally either the file "startnet" or
  2298. "stopnet" in the AMITCP:bin directory.  If you are using Miami, two AREXX
  2299. scripts, called "startnet.miami" and "stopnet.miami" have been provided
  2300. with the AEMail archive located in the AEMail program directory.
  2301.  
  2302. When first presented, these two string gadgets will contain the values
  2303. given in your STARTNET= and STOPNET= Tool Types or what was last stored in
  2304. your configuration file.  If these two Tool types are not present, these
  2305. two string gadgets will be blank unless a previous configuration file is
  2306. present and has these calls.
  2307.  
  2308. If you do not want what is presented as the default in these two string
  2309. gadgets, you can enter the correct path and script name in the string
  2310. gadgets.  A full path name to that script must be entered.  If the script
  2311. is an ARexx script you should check "ARexx command".  Do not precede the
  2312. script name with "rx ".  The standard AmiTCP startnet script is NOT an
  2313. ARexx script even though it uses ARexx commands.  It is an AmigaDOS
  2314. script.  The Miami script which comes with AEMail, on the other hand, is
  2315. an ARexx script.
  2316.  
  2317. The [|=|] button (a file folder glyph) brings up a file requester to allow
  2318. you to find the script you want.  When the string gadget is active you can
  2319. also use Right Amiga 'f' to bring up the file requester.
  2320.  
  2321. [CLR] will clear the string gadget.  When the string gadget is active you
  2322. can also use Right Amiga 'x' to clear the string gadget.
  2323.  
  2324. [DEFAULT] will place the script path and name from your Tool Types in the
  2325. appropriate string gadget.  When you are in the string gadget you can use
  2326. the string editing key, Left Amiga 'd', to also bring the default into the
  2327. string gadget.
  2328.  
  2329. If you need the "Start Net" script or the "Stop Net" script to open on the
  2330. workbench screen, click on the approriate check mark gadget for the
  2331. particular script.  When the TCP/IP Configuration page first opens the
  2332. "Start Net Opens on the Workbench" item will be checkmarked.
  2333.  
  2334. SPECIAL NOTE FOR USERS OF TERMITE TCP:
  2335.  
  2336. If you are using a TCP/IP stack that does not have a Start Net or Stop Net
  2337. script (such as TermiteTCP), you should use the [CLR] button to clear
  2338. these two string gadgets.  Starting and stopping your Internet connection
  2339. is then done manually.  Then when you use the Start Net or Stop Net menu
  2340. item, the action that is performed is to iconify AEMail.  You can then
  2341. perform the network connection in what ever manner was provided by your
  2342. TCP/IP stack software.  Once the connection is made, un-iconify AEMail and
  2343. AEMail will then check your POP Server for any available messages if that
  2344. option was selected (see below).
  2345.  
  2346. The "Automatic connection to Internet on AEMail Start Up" check box
  2347. provides the same capability as the AUTOCONNECT=YES Tool Type.  When
  2348. AEMail is first activated it attempts to determine if you are connected to
  2349. your Internet provider.  If you are not and this item is checked, AEMail
  2350. will automatically run your StartNet script.  However, the AUTOCONNECT
  2351. function will be disabled if you do not have a "Start Net" script.
  2352.  
  2353. Except when you are using AEMail as a mailto:  agent or when you use the
  2354. ARexx command "QUIT", when AEMail terminates and you are still connected
  2355. to your Internet provider, the following requester will be displayed:
  2356.  
  2357.             Do you wish to terminate your Host connection now?
  2358.  
  2359. You will given the opportunity to reply with either a [YES] or [NO].  If
  2360. you never want you Internet connection to be terminated when you exit from
  2361. AEMail, you can prevent the above requester from being displayed by NOT
  2362. checking the "Display disconnect check on AEMail exit" box.  By default,
  2363. this box WILL BE CHECKED, so, to disable the function, you would have to
  2364. click in this box.  However, this function will automatically be disabled
  2365. if you do not have a Stop Net script.
  2366.  
  2367. Please Note:  The way AEMail determines if you are still connected is to
  2368. check if the "bdsocket.library" is present.  This library may become
  2369. present when you load your TCP/IP stack software.  Even though you may not
  2370. be connected the bdsocket.library will then be present, so you will get
  2371. the above notification even though you are not actually connected.  In
  2372. this event replying with either [YES] or [NO] to the requester will have
  2373. no effect.
  2374.  
  2375. Whenever AEMail is first loaded and is connected to Internet Provider or
  2376. if you select "Start Net" from the "TCP/IP" menu, a check will be made for
  2377. any mail on your POP server or any mail that must be sent from your QUEUED
  2378. folder.  Except when you are using AEMail as a "mailto:" agent, this same
  2379. check is also performed when you quit AEMail.  You can disable any of
  2380. these checks by checking the appropriate box in the following lines:
  2381.  
  2382. Disable Queued Mail Check [] on Internet connection [] at AEMail exit
  2383.    Disable New Mail Check [] on Internet connection [] at AEMail exit
  2384.  
  2385. AEMail also has the capability for checking for mail periodically on your
  2386. POP server.  This function is performed in the background so you can be
  2387. doing other activities while this check is going on.  When mail is found,
  2388. the following requester will pop up on your screen:
  2389.  
  2390.  
  2391.                              YOU HAVE MAIL!!
  2392.  
  2393.                   n Messages available on the POP Server
  2394.  
  2395.                 Do you wish to receive these messages now?
  2396.  
  2397.  
  2398. Replying [YES] to the above requester will start the retrieval of the
  2399. messages.  If you are in iconify mode when this occurs, the retrieval will
  2400. occur in the background without bringing up the AEMail screen.
  2401.  
  2402. You can set the time interval for this check by entering the appropriate
  2403. number of minutes in the following numeric gadget:
  2404.  
  2405.                   Check for new mail every [  ] minutes
  2406.  
  2407. The default time interval is 2 minutes.  If you enter a zero in this
  2408. numeric gadget, no check will be made.  This gadget has an up/down arrow
  2409. for incrementing or decrementing the value.  You can not decrement it
  2410. below zero.
  2411.  
  2412.  
  2413.                             Default Path Page
  2414.                             -----------------
  2415.  
  2416.  
  2417. The Default Path page appears as follows:
  2418.  
  2419. =========================================================================
  2420. [o] AEMail Configuration Setup
  2421. -------------------------------------------------------------------------
  2422.                       -------
  2423.  ____________________| Paths |__________________________________________
  2424. |                                                                       |
  2425. |            Mail Directory: [                                         ]|
  2426. |                                                                       |
  2427. |          TCP Logging File: [                      ][|=|][CLR][DEFAULT]|
  2428. |                                                                       |
  2429. |                            [ ] TCP Logging Active on AEMail startup   |
  2430. |                                                                       |
  2431. |   Retrieve Mail Directory: [                      ][|=|][CLR][DEFAULT]|
  2432. |                                                                       |
  2433. |       Save Mail Directory: [                      ][|=|][CLR][DEFAULT]|
  2434. |                                                                       |
  2435. | Add Attachments Directory: [                      ][|=|][CLR][DEFAULT]|
  2436. |                                                                       |
  2437. |Save Attachments Directory: [                      ][|=|][CLR][DEFAULT]|
  2438. |_______________________________________________________________________|
  2439.  
  2440. [      Use      ] [      Save      ] [    Save As    ] [     Cancel     ]
  2441.  
  2442. ==========================================================================
  2443.  
  2444. String gadgets are provided for giving the full path for each of the
  2445. default directories and or file.  The directory paths that can be
  2446. specified are:
  2447.  
  2448.     Mail Directory: This is the directory that contains your
  2449.         mail files.  This string gadget is read only and cannot be
  2450.         modified.  It is for informational purposes only.  To change
  2451.         mail directory you will have to change it with the Installation
  2452.         script with an update for this user.
  2453.  
  2454.     TCP Logging File:  This allows you to enter a file name as well
  2455.         as a path.  The default path and file name is "tcplog" in
  2456.         the AEMail program directory.  If this field is cleared, no
  2457.         TCP logging can take place.  When the [SAVE], [SAVE AS] or
  2458.         [USE] gadgets are selected, if TCP Logging was active and
  2459.         the TCP logging File name that was entered is different
  2460.         from the current log file, the current log file will be
  2461.         closed and a new file opened.  If you clear this field
  2462.         TCP logging will stop since there is no file to log to.
  2463.  
  2464.         Whether logging takes place or not will depend on the
  2465.         "TCP/IP/TCP Logging File/Active" menu item (checkmarked
  2466.         flag).
  2467.  
  2468.         You can cause TCP logging to be active when AEMail starts
  2469.         up by checking the "TCP Logging Active on AEMail startup"
  2470.         check mark gadget below the TCP Logging File string gadget.
  2471.         If this item is checked, the logging will become active
  2472.         when you exit from Configuration Setup.  You will have
  2473.         to turn off the Active flag in the "TCP/IP/TCP Logging File"
  2474.         menu item to stop logging.
  2475.  
  2476.         Note: none of the actions mentioned above will take place
  2477.         until you select [USE], [SAVE] or [SAVE TO] at the bottom
  2478.         of the Configuration Setup Window.  If you select [CANCEL] no
  2479.         change will be made in your TCP logging activity.
  2480.  
  2481.     Retrieve Mail Directory:  This is the initial path that will
  2482.         appear in the file requester when you Retrieve mail from a
  2483.         file rather than your POP Server.  The default directory for
  2484.         these files is "PROGDIR:" which is your current AEMail program
  2485.         directory.  If you regularly are trying to bring in mail that
  2486.         was previously transferred using another mail user agent such
  2487.         as AmiPOP, AirMail, or Voodoo, you should use the directory
  2488.         that was used for these agents for storing mail.  You can
  2489.         specify any directory of your choosing as the default path
  2490.         for the Retrieve Mail file requester.  You enter that
  2491.         default in this string gadget.
  2492.  
  2493.     Save Mail Directory:  This is the initial path that will appear
  2494.         in the file requester when you select the "Save Mail" icon
  2495.         in the command icon strip.  The default directory for this
  2496.         path is PROGDIR:, which is your current program directory.
  2497.         However, you can specify any other path of your choosing as
  2498.         the default path for the Save Mail file requester.  You enter
  2499.         that default in this string gadget.
  2500.  
  2501.     Add Attachments Directory:  This is the initial path that will
  2502.         appear in the file requester when you select the [REQ] button
  2503.         in the Add Attachment requester (see below under Section VIII.
  2504.         AEMail WINDOWS.  The default directory for this path is PROGDIR:.
  2505.         However, you can specify any other path of your choosing as
  2506.         the default path for the Add Attachment requester.  You enter
  2507.         that default in this string gadget.
  2508.  
  2509.     Save Attachments Directory:  This is the initial path that will
  2510.         appear in the file requester when you select the [Save] or
  2511.         [View & Save] buttons in the Attachment requester (see below
  2512.         under Section VIII. AEMail WINDOW.  The default directory for
  2513.         this path is RAM:.  However, you can specify any other path of
  2514.         your choosing as the default path for the Attachment file
  2515.         requester.  You enter that default in this string gadget.
  2516.  
  2517. When this page is first activated, the values that were last saved in the
  2518. current configuration file will be displayed.
  2519.  
  2520. The buttons to the side of each string gadget perform the following
  2521. actions:
  2522.  
  2523.     [|=|] (a file folder glyph) causes a file requester to appear for
  2524.         selecting the appropriate directory and file name (TCP Logging
  2525.         File only) to be loaded into the appropriate string gadget.
  2526.         The file requester will start out with the last path that was
  2527.         used for that particular string gadget.  If no path was last
  2528.         used, a dummy name of "VOLUMES" will be used, the requester
  2529.         will flash, and the volumes and assigns will be displayed.
  2530.  
  2531.         When the string gadget is active you can also use Right Amiga 'f'
  2532.         to bring up the file requester.
  2533.  
  2534.     [CLR] will cause the string gadget to be cleared.  When the string
  2535.         gadget is active you can also use Right Amiga 'x' to clear the
  2536.         string gadget.
  2537.  
  2538.     [DEFAULT] will cause default information, as described above, to be
  2539.         loaded into the appropriate string gadget except that the PROGDIR:
  2540.         designation will be expanded to the full path name of the program
  2541.         directory.  When the string gadget is active, you can also use
  2542.         Right Amiga 'd' to bring the default information into the string
  2543.         gadget.
  2544.  
  2545.                                Viewer Page
  2546.                                -----------
  2547.  
  2548. The Viewer page appears as follows:
  2549.  
  2550. =========================================================================
  2551. [o] AEMail Configuration Setup
  2552. -------------------------------------------------------------------------
  2553.                               --------
  2554.  ____________________________| Viewer |_________________________________
  2555. |  __________________________________________________________________   |
  2556. | | Mime Type/Subtype | Viewer Program                               |  |
  2557. | |---------------------------------------------------------------------|
  2558. | | text/*            | sys:Utilities/multiview %s                   | ||
  2559. | | message/*         | sys:Utilities/multiview %s                   | ||
  2560. | | image/*           | sys:Utilities/multiview %s screen            | ||
  2561. | | audio/*           | sys:Utilities/multiview %s screen            | ||
  2562. | | video/*           | sys:Utilities/multiview %s screen            | ||
  2563. | |                   |                                              | ||
  2564. | |                   |                                              |^||
  2565. | |___________________|______________________________________________|V||
  2566. |                                                              ________ |
  2567. | Mime Type: [ text              |<] / [                 ][*] |        ||
  2568. |                                                             |[ New  }||
  2569. |            [] Opens on Workbench [] Called with Run [] ARexx|        ||
  2570. |                                                             |[Delete]||
  2571. |    Viewer: [                                        ] [|=|] |        ||
  2572. |                                                             |[  OK  ]||
  2573. | Arguments: [                                        ] [%s ] |________||
  2574. |_______________________________________________________________________|
  2575.  
  2576. [      Use      ] [      Save      ] [    Save As    ] [     Cancel     ]
  2577.  
  2578. =========================================================================
  2579.  
  2580. The Viewer page is used to create and or modify your mailcap file.  When
  2581. the page is activated the currrent mailcap file will be displayed in the
  2582. listview list.  The items at the bottom of the page will be disabled with
  2583. the exception of the [ New ] button.
  2584.  
  2585. To create a new entry in the mailcap, click on [ New ].  At this point all
  2586. of the items at the bottom of the page, with the exception of the [Delete]
  2587. button will become enabled.  You can now enter the information for the
  2588. mailcap entry in the gadgets below the listview.
  2589.  
  2590. Mime Type: is a chooser box.  If you click into the body of the gadget, a
  2591. list of mime types will appear as follows:
  2592.  
  2593.     text
  2594.     message
  2595.     image
  2596.     audio
  2597.     video
  2598.  
  2599. You can choose the Mime Type that you want and it will be transferred to
  2600. the Mime Type box.  The button to the right of the box ([<]) acts like a
  2601. cycle gadget, cycling through the varies Mime Types.
  2602.  
  2603. The large box to the right of the "/" is for the mime subtype.  It is a
  2604. string gadget in which you can enter the subtype you want.  The gadget [*]
  2605. to the right of this brings up a list of possible mime subtypes.  You can
  2606. select from this list, or, if the one you want is not in the list, enter it
  2607. into the string gadget.  If you select from the list, it will be
  2608. transferred to the string gadget.
  2609.  
  2610. The boxes below the Mime Type/Subtype row are for entering information
  2611. about your viewer.  The check boxes, "Opens On Workbench", "Called with
  2612. Run" and "ARexx", indicate how your viewer program will be executed.  If
  2613. "Opens On Workbench" is checked, your viewer program will open on the
  2614. Workbench.  If the viewer program must be called with "run >NIL:", check
  2615. the "Called with Run" box, and if it is an ARexx command, check the
  2616. "ARexx" box.
  2617.  
  2618. The string gadget, Viewer:, contains the full path name of your viewer
  2619. program.  The [|=|] (folder glyph) calls up a file requester so you can
  2620. select the Viewer program from the file list.
  2621.  
  2622. Enter any arguments the Viewer program needs into the Arguments: string
  2623. gadget.  You must always have a "%s" in the argument to specify the file
  2624. that will be displayed with the viewer.  If you click on the [%s] gadget,
  2625. a %s will be placed at the end of what has so far been typed into the
  2626. argument.
  2627.  
  2628. Also, the normal clipboard commands (Right Amiga 'c', Right Amiga 'v',
  2629. etc) work in any of the string gadgets.
  2630.  
  2631. When everything is entered correctly, click on [ OK ].  Your Mime
  2632. Type/Subtype and Viewer Program will be trasferred to the listview.
  2633. Placement of the line in the listview will be according to the Mime Type
  2634. positioning (i.e., text before message before image, etc.).
  2635.  
  2636. As an example of how the Viewer program entry gadgets work let's assume
  2637. you have entered or checked:
  2638.  
  2639.     "Called with Run"
  2640.     "ARexx"
  2641.     Viewer: REXX:html.aem
  2642.     Arguments: %s
  2643.  
  2644. The following will be shown under the Viewer Program:
  2645.  
  2646.     run >NIL: rx REXX:html.aem %s
  2647.  
  2648. If you had added "Opens On Workbench", the following would be shown:
  2649.  
  2650.     wb;run >NIL: rx REXX:html.aem %s
  2651.  
  2652. Consult Section X. AEMAIL FILES, mailcap for a complete description of the
  2653. mailcap file.
  2654.  
  2655. If you want to modify or delete an entry in your mailcap file, simply
  2656. click on the entry in the listview.  Information from the listview line
  2657. you clicked on will be transferred to the gadgets below the listview.  The
  2658. Mime Type/Subtype row will be disabled allowing you to only modify the
  2659. Viewer program.
  2660.  
  2661. If you click on [Delete], the entry in the listwiew will be deleted.  If
  2662. you click on [ OK ] after making any changes in your Viewer program, the
  2663. line for that Mime Type/Subtype in the listview will be replaced with the
  2664. information you just modified.
  2665.  
  2666. If you wish to recover an entry you have just deleted, information about
  2667. that entry will remain in the gadgets even though the gadgets are
  2668. disabled.  Clicking on [ New ] and then [ OK ] will restore the entry.
  2669.  
  2670. You are not allowed to create a new Mime Type/Subtype that is the same as
  2671. an existing Mime Type/Subtype.
  2672.  
  2673.                                 ARexx Page
  2674.                                 ----------
  2675.  
  2676.  
  2677. The ARexx page appears as follows:
  2678.  
  2679. =========================================================================
  2680. [o] AEMail Configuration Setup
  2681. -------------------------------------------------------------------------
  2682.                                        -------
  2683.  _____________________________________| ARexx |_________________________
  2684. |                                                                       |
  2685. | ___________________________________________________________________   |
  2686. || Event/Key|Title   |Type |FLG|Command                              |  |
  2687. ||----------------------------------------------------------------------|
  2688. || Web Addr |        |AREXX|   |AEMail2:ARexx/html.aem               | ||
  2689. ||Email Add |        |AREXX|   |AEMail2:ARexx/sendmsg.aem            | ||
  2690. ||          |        |     |   |                                     | ||
  2691. ||       F1 |Get WWW |AREXX|   |REXX: html.aem                       | ||
  2692. ||       F2 |IBROWSE |DOS  | A |IBrowse:IBrowse                      | ||
  2693. ||       F3 |Place In|AREXX|   |AEMail2:ARexx/placeaddr.aem          | ||
  2694. ||       F4 |Place Ad|AREXX|   |AEMail2:ARexx/placegrp.aem           | ||
  2695. ||       F5 |Delete A|AREXX|   |AEMail2:ARexx/deladrgrp.aem          | ||
  2696. ||       F6 |        |     |   |                                     |^||
  2697. ||       F7 |        |     |   |                                     |V||
  2698. |-----------------------------------------------------------------------|
  2699. | ------------Select Event/Function Key from the above list------------ |
  2700. ||                                                                     ||
  2701. || [AREXX |<] [                                          ] [|=|] [CLR] ||
  2702. ||                                                                     ||
  2703. || Menu Title: [                    ]                            [CLR] ||
  2704. ||                                                                     ||
  2705. || [ ] Opens on Workbench        [ ] Executes Asychronously       [OK] ||
  2706. ||_____________________________________________________________________||
  2707. |_______________________________________________________________________|
  2708.  
  2709. [      Use      ] [      Save      ] [    Save As    ] [     Cancel     ]
  2710.  
  2711. ==========================================================================
  2712.  
  2713. The ARexx Page will allow you to assign ARexx or DOS commands to function
  2714. keys and to certain events that occur within AEMail.  It will also allow
  2715. you to assign a menu title for the ARexx or DOS command that will be
  2716. placed in the ARexx/DOS menu.
  2717.  
  2718. At the present time there are only two events that can be defined:  when
  2719. you double click on a web address in a message or when you double click on
  2720. an email address in a message.
  2721.  
  2722. At the top of the page is a scrolling listview that displays all of the
  2723. events and function keys on the left hand side.  Not only are function
  2724. keys included in the list, but also the shift key plus the function keys
  2725. (SHFT Fn), the control key plus the function keys (CTRL Fn), and the Alt
  2726. key plus the function keys (ALT Fn).  This gives the possibility of 40
  2727. commands being associated with function keys; although, some key
  2728. combinations may not be effective if they are used by other programs or
  2729. commodities.
  2730.  
  2731. The column entitled "Title" gives the Menu Title that will be used in the
  2732. ARexx/DOS menu.  If an entry in the column is blank, no menu entry will be
  2733. made for this command.
  2734.  
  2735. The column entitled "Type" indicates the type of command: AREXX or DOS.
  2736. The "FLG" column indicates "W" if the command opens on the Workbench and
  2737. "A" if the command executes asychronously (with RUN >NIL:).  These two
  2738. flags only apply to DOS commands.
  2739.  
  2740. The "Command" column indicates the AREXX or DOS command script or program
  2741. that will be executed when the function key is pressed.  This should be
  2742. the full path name for the script or program.
  2743.  
  2744. In the example above, the two events have been defined to call html.aem,
  2745. which calls your selected browser if a web address is double clicked, and
  2746. sendmsg.aem to send an email message to the selected address if a email
  2747. address is double clicked.
  2748.  
  2749. Since other action may be desireable when an email address is selected,
  2750. you will notice that the F3, F4, and F5 function keys have been defined to
  2751. call placeaddr.aem (to place address in address book), placegrp.aem (to
  2752. place address in a group), and deladrgrp.aem (to delete address from a
  2753. group) respectively.  They have also been defined with menu items ("Place
  2754. Individual Address", "Place Address in Group", and "Delete Address from
  2755. Group".
  2756.  
  2757. To ensure that the sendmsg.aem script is not automatically called when you
  2758. double click on the email address, you will have to hold down the CTRL key
  2759. when you double click.  This will bring up the Clipboard requester (see
  2760. Using the Clipboard with AEMail) and you can either press the appropriate
  2761. function key or select the appropriate menu item to execute the ARexx
  2762. script.
  2763.  
  2764. Below the listview is a boxed area which initially has the heading "Select
  2765. Event/Function Key from the above list".  Initially all of the gadgets in
  2766. this boxed area are disabled.
  2767.  
  2768. When you click on one of the events or function keys in the listview, the
  2769. heading of the boxed area changes to "Command for Fn", where Fn is the
  2770. function key you clicked on (or "Command for event"), and the boxed area
  2771. becomes enabled.  If there was a command already defined for that function
  2772. key or event, the information will be transferred to the appropriate
  2773. gadgets within the boxed area.
  2774.  
  2775. The cycle gadget (indicated by |<]) has two states: AREXX and DOS.  If you
  2776. select AREXX the checkmarked gadgets "Opens on Workbench" and "Executes
  2777. Asychronously" are disabled; they only are used with DOS commands.
  2778.  
  2779. The string gadget following the cycle gadget is for entering the full path
  2780. name of your ARexx or DOS script or DOS program.  The [|=|] (file folder
  2781. glyph) is used to bring up a file requester to find the script or program
  2782. that you want.  If you have activated the string gadget, you can also use
  2783. Right Amiga 'f' to call up the file requester.
  2784.  
  2785. The [CLR] next to the file folder glyph the will clear this string gadget;
  2786. although Right Amiga 'x' will also do this if the string gadget is
  2787. enabled.  The string gadget also supports clipboard actions.
  2788.  
  2789. The "Menu Title" string gadget is used to assign a menu name to the
  2790. ARexx/DOS menu that will call this command.  A maximum of 21 characters
  2791. can be used for a Menu Title.  If this string gadget is left blank, no
  2792. menu name will be assigned and you can only use the appropriate function
  2793. key to call the command.  The [CLR] to the far right on this row clears
  2794. the Menu Title.  When you are in the string gadget, Right Amiga 'x' will
  2795. also clear the string.  This string gadget also supports clipboard
  2796. actions.
  2797.  
  2798. The two checkmark gadgets on the second row are used for DOS commands
  2799. only.  They will be disabled for ARexx commands.
  2800.  
  2801. If "Opens on Workbench" is checked, a switch will be made to the Workbench
  2802. screen when the command is executed.  This is not necessary for ARexx
  2803. command since there is an AEMail ARexx command that will do this.
  2804.  
  2805. The "Execute Asynchronously" checkmark gadget is used to execute the DOS
  2806. command in the background.  This will allow AEMail to function when the
  2807. program that is called is being executed.  This item is, by default,
  2808. checkmarked.  If for some reason you want AEMail to freeze while the
  2809. command (program) is being executed, you can un-checkmark this item.
  2810. Since all ARexx commands automatically execute in the background, this item
  2811. is uneccessary for ARexx command scripts.
  2812.  
  2813. When you have completed entering the data, click on [OK].  The information
  2814. will be transferred to the appropriate entry in the listview.  If you
  2815. cleared the string gadget, any command information, including Type and
  2816. FLGS as well, will be cleared for this event or function key in the
  2817. listview.
  2818.  
  2819. Please Note:  If you are an Un-Registered user of AEMail, you can not save
  2820. the ARexx/DOS command list.  This means that whenever you quit AEMail the
  2821. list of commands will not be remembered.  You will need to re-enter them
  2822. the next time you load AEMail.
  2823.  
  2824.                                 Fonts Page
  2825.                                 ----------
  2826.  
  2827.  
  2828. The Fonts page appears as follows:
  2829.  
  2830. =========================================================================
  2831. [o] AEMail Configuration Setup
  2832. -------------------------------------------------------------------------
  2833.                                                -------
  2834.  _____________________________________________| Fonts |_________________
  2835. |                                                                       |
  2836. | -Configuration Page Font------------------------ ____________________ |
  2837. |                                                 |                    ||
  2838. | Font: [topaz.font  ] Size: [  8] [Ff] [DEFAULT] |AaBbCcDcEeFfGg..1234||
  2839. |                                                 |____________________||
  2840. | -AEMail Screen Font----------------------------- ____________________ |
  2841. |                                                 |                    ||
  2842. | Font: [topaz.font  ] Size: [  8] [Ff] [DEFAULT] |AaBbCcDcEeFfGg..1234||
  2843. |                                                 |____________________||
  2844. | -AEMail General Font---------------------------- ____________________ |
  2845. |                                                 |                    ||
  2846. | Font: [topaz.font  ] Size: [  8] [Ff] [DEFAULT] |AaBbCcDcEeFfGg..1234||
  2847. |                                                 |____________________||
  2848. | -Folder Font------------------------------------ ____________________ |
  2849. |                                                 |                    ||
  2850. | Font: [topaz.font  ] Size: [  8] [Ff] [DEFAULT] |AaBbCcDcEeFfGg..1234||
  2851. |                                                 |____________________||
  2852. | -Message Font----------------------------------- ____________________ |
  2853. |                                                 |                    ||
  2854. | Font: [topaz.font  ] Size: [  8] [Ff] [DEFAULT] |AaBbCcDcEeFfGg..1234||
  2855. |                                                 |____________________||
  2856. |_______________________________________________________________________|
  2857.  
  2858. [      Use      ] [      Save      ] [    Save As    ] [     Cancel     ]
  2859.  
  2860. =========================================================================
  2861.  
  2862.  
  2863. The Fonts Page will allow you to change the fonts for certain AEMail
  2864. displays.  The areas that you can change fonts for are:
  2865.  
  2866.     Configuration Page Font
  2867.     AEMail Screen Font
  2868.     AEMail General Font
  2869.     Folder Font
  2870.     Message Font
  2871.  
  2872. The Configuration Page Font will change the font for the Configuration
  2873. screen and each of the pages on it.  If you are running on a
  2874. non-interlaced Workbench screen with a width of no more than 640
  2875. characters, you might find that you will have to change this font to allow
  2876. everything to fit on the screen.  You can use any font or font size
  2877. including proportional or fixed fonts.
  2878.  
  2879. The Configuration Page Font will not take effect until you exit from the
  2880. Configuration Setup Window and then recall the Configuration Setup Window.
  2881.  
  2882. The AEMail Screen Font will change the font for the main AEMail screen and
  2883. window titles, the font used by system requesters, and the font used for
  2884. menus.  Any font or font size can be used, fixed or proportional.  This
  2885. will not effect the screen font used by the Configuration Setup Window,
  2886. however.  You will have to do that with the Workbench Fonts Preferences.
  2887.  
  2888. The Folder Font will only change the font in the folder strip.  It has the
  2889. same effect as the FLDRFONT= and FLDRFONTSZ= Tool Types.  Any font or font
  2890. size can be used, fixed or proportional.
  2891.  
  2892. The Message Font will change the font used for displaying messages.  While
  2893. any font or font size, fixed or proportional, can be used, watch out for
  2894. proportional fonts.  If the message has long lines, it may take
  2895. significantly longer to display the message than with a fixed font.
  2896.  
  2897. Finally, the AEMail General Font effects the body fonts used in all other
  2898. windows in AEMail.  This font has certain restrictions.  It must be size 8
  2899. and must be a fixed font.
  2900.  
  2901. The only gadgets that are active for each font are the [Ff] and [DEFAULT]
  2902. gadgets.  [Ff] will bring up a font requester so that you can select the
  2903. font you want and [DEFAULT] will change the font to topaz.font size 8.
  2904. The Font: and Size: gadgets are read only to show you what font is
  2905. currently being used and the boxed area to the right which shows a sample
  2906. of the font.  If you want to change a font use the font requester.
  2907.  
  2908. Take care when you change fonts.  If you do not choose your fonts
  2909. carefully, you could end up with windows that are too big to fit on the
  2910. ecreen or requesters that are chopped off at the bottom.  A proportional
  2911. font used as the Screen font could cause certain requesters to appear
  2912. mis-proportioned.
  2913.  
  2914.                          General Parameters Page
  2915.                          -----------------------
  2916.  
  2917.  
  2918. The General Parameters page appears as follows:
  2919.  
  2920. =========================================================================
  2921. [o] AEMail Configuration Setup
  2922. -------------------------------------------------------------------------
  2923.                                                        ---------
  2924.  _____________________________________________________| General |_______
  2925. |                                                                       |
  2926. | Printer Device: [PRT:        ][|=|][CLR][DEFAULT]   Top Margin:[ 4]/| |
  2927. |                                                                       |
  2928. | [ ] Include Attachment List in Print Out              [Printer Setup] |
  2929. |                                                                       |
  2930. |           Editor: [                              ][|=|][CLR][DEFAULT] |
  2931. |                                                                       |
  2932. | Editor Arguments: [               ] [ ] Editor Opens on the Workbench |
  2933. |                                                                       |
  2934. | ------------------Default Reply to Message Parameters---------------- |
  2935. ||                                                                     ||
  2936. || [ ] Quote Original Message Text          Quote Prefix: [>         ] ||
  2937. ||                                                                     ||
  2938. || Quote Header: [                                                   ] ||
  2939. | --------------------------------------------------------------------- |
  2940. |                                                                       |
  2941. | [ ] Clone Workbench Screen Mode                     [Set Screen Mode] |
  2942. |                                                                       |
  2943. | [Set Minimum Headers]                                [Set Menu Flags] |
  2944. |_______________________________________________________________________|
  2945.  
  2946. [      Use      ] [      Save      ] [    Save As    ] [     Cancel     ]
  2947.  
  2948. =========================================================================
  2949.  
  2950.  
  2951. The General Parameter page allows you to set up certain general type
  2952. parameters such as specifications for your printer device, the screen
  2953. mode that you want your AEMail screen to open on, the list of minimum
  2954. headers you want displayed in a message, certain default menu checkmarked
  2955. items, the specification for your editor, and the specifications for the
  2956. default message reply headers.
  2957.  
  2958. For the Printer Device you can specify the device that you want to do your
  2959. printing on.  By default this is PRT:, but you can specify a file if you
  2960. care to.  If you specify a file, your printer output will be sent as
  2961. standard ASCII text with form feeds and margin spacing included in the
  2962. output.  The [|=|] (file folder glyph) button will call up a file
  2963. requester through which you can enter the path and file name of this
  2964. printer file.  [CLR] will clear the string gadget and [DEFAULT] will enter
  2965. PRT:  into the gadget.  When this page is first displayed, the PRT:
  2966. default will be in the gadget.
  2967.  
  2968. If the Printer Device string gadget is activated you can also use Right
  2969. Amiga 'f' to call up the file requester, Right Amiga 'x' to clear the
  2970. string, and Right Amiga 'd' to bring PRT: into the gadget.
  2971.  
  2972. You can also specify the Top Margin of the printout with the numeric
  2973. string gadget to the right of the Printer Device.  The default top margin
  2974. is 4.
  2975.  
  2976. If you want the list of attachments to appear on the last page of your
  2977. printout, you can check the "Include Attachment List in Print Out" box.
  2978. By default, this box is checked when you first call up the General
  2979. Parameters page.
  2980.  
  2981. If you want to modify your printer setup parameters that are normally set
  2982. with your PRINTER PREFERENCES, you can click on the [Printer Setup]
  2983. button.  This will call up the standard Printer Preferences program so
  2984. that you can change your printer setup.  Please Note that, if you change
  2985. the printer preferences, the new preferences will remain in effect when
  2986. you quit AEMail.
  2987.  
  2988. For the Editor: string gadget you must use the full path name of the
  2989. editor of your choice.  The Editor Arguments: string gadget is used to
  2990. enter any parameters you want to use when you call your editor.  To
  2991. specify where the file name you are editing goes use '%s'.  An example
  2992. would be:
  2993.  
  2994.     Editor: c:ed
  2995.     Editor Arguments: %s
  2996.  
  2997. Next to the Editor Arguments:  string gadget is a checkmark gadget which
  2998. is used to tell AEMail that your editor will open on the Workbench screen.
  2999. If your editor of choice does not open on it's own screen, you must check
  3000. this item.  The AmigaDos editor, ED, does NOT open on it's own screen;
  3001. therefor you must check this item if you are using ED.
  3002.  
  3003. The [DEFAULT] for the Editor is the information from the EDITOR= Tool Type.
  3004. If the key word 'WB;' precedes the editor call information in the tool
  3005. type, the "Editor Opens on Workbench" item will be checkmarked.  'WB;'
  3006. will NOT appear in the Editor string gadget.
  3007.  
  3008. If the EDITOR Tool Type was not provided, the following will be the
  3009. default edit call:
  3010.  
  3011.     Editor: c:ed
  3012.     Editor Arguments: %s
  3013.  
  3014. and the "Editor Opens on Workbench" item will be checkmarked.  This
  3015. uses the default AmigaDos editor, ed.
  3016.  
  3017. If you need to find where your editor is located, [|=|] (file folder
  3018. glyph) causes a file requester to appear for selecting the appropriate
  3019. program file to be loaded into the Editor string gadget.
  3020.  
  3021. If the Editor: string gadget is activated you can use Right Amiga 'f' to
  3022. call up the file requester, Right Amiga 'd' to call up the default, and
  3023. Right Amiga 'x' to clear the Editor: string gadget.
  3024.  
  3025. The section below the heading "Default Reply to Message Parameters" is
  3026. used to set up the default actions when you are replying to a message.
  3027. The "Quote Original Message Text" box sets up the default action for
  3028. quoting the original text in a message.  Even though you take the default
  3029. of not quoting text, you will be given an opportunity to change you mind
  3030. about this when you compose the message.
  3031.  
  3032. The "Quote Prefix:" string gadget indicates what is to be placed in front
  3033. of each quoted line if an original message is quoted.  This, by default,
  3034. is '>'; however, you can use any other prefix as the derfault that you
  3035. like.
  3036.  
  3037. A "Quote header:" will be placed on the line in front of the quoted
  3038. material.  You can choose what you would like as the default heading and
  3039. enter it in this string gadget.  By default, the header which will
  3040. initially appear in the "Quote Header:" string gadget is:
  3041.  
  3042.     On &(week), &(date2), at &(time), &(name) wrote:
  3043.  
  3044. The & followed by a field name in parenthesis indicates substitution of
  3045. data from the original message's headers.  The values that can be
  3046. substituted are:
  3047.  
  3048.     &(name)     The real name of the sender of the original
  3049.                 message.  If the real name is not available,
  3050.                 the sender's email address will be used instead
  3051.  
  3052.     &(subject)  The subject from the original message.  Any RE:
  3053.                 or (fwd) will be stripped.
  3054.  
  3055.     &(week)     The day of the week that the original message
  3056.                 was sent.
  3057.  
  3058.     &(date)     The date the original message was sent in the form
  3059.                 DD MMM YYYY, where DD is the day of the month,
  3060.                 MMM is month in the form Jan, Feb, Mar, etc, and
  3061.                 YYYY is the full 4 digit year.
  3062.  
  3063.     &(date1)    Same as &(date).
  3064.  
  3065.     &(date2)    The date in the form MMM DD, YYYY.
  3066.  
  3067.     &(time)     The time the original message was sent in the
  3068.                 form HH:MM xM where HH is the hour on a 12 hour
  3069.                 clock, MM is the minute, and xM is AM or PM.
  3070.  
  3071.     &(to)       The email address the message was sent to.  For
  3072.                 mailing lists this could be the name of the mailing
  3073.                 list if that is what appeared in the To: header.
  3074.  
  3075. The "Quote Header" is designed to be modified by the user and can be
  3076. changed with this string gadget.  This is a permanent change if you select
  3077. [SAVE] to save the Configuration data or it can be in effect as the
  3078. default for only this running of AEMail if you select [USE].  You can
  3079. always change this default, however, when you compose a message.
  3080.  
  3081. If you want to set your screen mode for AEMail, you can click on the [Set
  3082. Screen Mode] button.  This will call up a Screen Mode Requester which will
  3083. allow you to set whatever screen mode you wish.  Your overscan mode can
  3084. also be set.  This defaults to "OVERSCAN-TEXT".
  3085.  
  3086. To the left of the [Set Screen Mode] button is a checkmark gadget labeled
  3087. "Clone Workbench Screen Mode".  If you select this gadget AEMail will use
  3088. whatever screen mode is currently set for your Workbench through the Set
  3089. Screen Mode Preferences program.  If the Workbench Screen Mode is changed,
  3090. AEMail will open with that screen mode the next time it is loaded.
  3091.  
  3092. If the "Clone Workbench Screen Mode" is checkmarked, the [Set Screen Mode]
  3093. button will be disabled.
  3094.  
  3095. When you save your configuration settings, the screen mode you selected
  3096. and the overscan setting are saved in the AEMail configuration file and
  3097. will be used the next time you load AEMail.  They will also be in effect
  3098. when you return from the Edit Configuration Setup Window.
  3099.  
  3100. The minimum header set that you want displayed in your message can be set
  3101. by clicking on the [Set Minimum Headers] button.  This will bring up a
  3102. requester that looks like this:
  3103.  
  3104.                    |==================================|
  3105.                    |[o]  Set Minimum Headers          |
  3106.                    |==================================|
  3107.                    |      Select/Deselect Headers     |
  3108.                    |          to be displayed         |
  3109.                    |==================================|
  3110.                    || *bcc:                        | ||
  3111.                    || *cc:                         | ||
  3112.                    ||  Content-Transfer-Encoding:  | ||
  3113.                    ||  Content-Type:               | ||
  3114.                    || *Date:                       | ||
  3115.                    || *From:                       | ||
  3116.                    |==================================|
  3117.                    |         Enter New Header         |
  3118.                    |[                                ]|
  3119.                    |                                  |
  3120.                    |              [OK]                |
  3121.                    |==================================|
  3122.  
  3123. A list of possible message headers is displayed in the scrollable list.
  3124. An asterick (*) in front of a header indicates that it has been selected
  3125. for inclusion in the minimum header list.  Clicking on an item in the list
  3126. will select it with an (*).  If it is already selected, it will be
  3127. deselected (the asterick will change to a blank).
  3128.  
  3129. The string gadget at the bottom of the requester is used to enter a header
  3130. that is not in the list.  Be sure and end the header with a colon (:).
  3131. After entering the header, press return and the header will be placed
  3132. properly in the scollable list.  It will be deselected when it is first
  3133. entered in the list.  You will have to click on it to select it.
  3134.  
  3135. When you are through entering items in the list, click on [OK] and you
  3136. will be returned to the General Parameters page.  Clicking on the close
  3137. gadget at to top of the requester has the same effect as clicking on [OK].
  3138.  
  3139. Please NOTE:  anything you enter in the list or select/deselect will
  3140. remain in the list in that state during the current run of AEMail even if
  3141. you click on [CANCEL] in the main configuration window.  In other words,
  3142. [CANCEL] for the minimum header list has the same effect as [USE].
  3143. Clicking on [SAVE] or [SAVE AS] at the bottom of the window will
  3144. permanently save the headers you have selected.
  3145.  
  3146. There is no way to delete a header once it has been entered in the list
  3147. and saved except by deleting the .headers file in the AEMAIL:  directory.
  3148. This is really not a problem, however, since, if you entered an incorrect
  3149. header and haven't selected it, it will have no effect on the program.
  3150.  
  3151. The [Set Menu Flags] gadget brings up a window that has five check boxes
  3152. in it.  These five check boxes are:
  3153.  
  3154.     [ ] Display Full Header
  3155.     [ ] Forward Body text Only
  3156.     [ ] Include Header in Reply
  3157.     [ ] Exclude Duplicate Messages
  3158.     [ ] Delete Host Mail
  3159.  
  3160. These check boxes correspond to the flags under the "Messages" and
  3161. "Retrieve Msgs" menus.  If you [SAVE] or [SAVE AS] when you exit from the
  3162. Configuration Setup, they will set the initial values of these menu items
  3163. when you load AEMail.  When you exit from the Configuration Setup with
  3164. either [USE], [SAVE] or [SAVE AS], the corresponding menu items will be
  3165. checked or unchecked depending on the state of these check boxes.
  3166.  
  3167. Clicking on the close gadget of the "AEMail Set Menu Flags" window or
  3168. clicking on [OK] will close this window.
  3169.  
  3170. Please Note: Because of a problem with ClassAct, the [Printer Setup]. [Set
  3171. Screen Mode], [Set Minimum Headers] and [Set Menu Flags] gadgets will not
  3172. work under AmigaDOS 2.x.  There is no problem with these gadgets under
  3173. AmigaDOS 3.x.
  3174.                              V. USING AEMAIL
  3175.  
  3176.                              Starting AEMail
  3177.                              ---------------
  3178.  
  3179. AEMail can be started either from the Workbench by double clicking on it's
  3180. icon or from the shell.  It is recommended that AEMail be normally run
  3181. from the Workbench.  The shell invocation is primarily designed for
  3182. "MailTo" agents in web browsers or to call AEMail from another program
  3183. that passes a message to it.
  3184.  
  3185.                       Starting AEMail from the Shell
  3186.                       ------------------------------
  3187.  
  3188. When AEMail is invoked from the shell, there are six optional arguments
  3189. that can be used as follows:
  3190.  
  3191.  AEMail [email-addr-of-recipient-of-email] [config=configuration_file]
  3192.    [pubscr=browser-screen-name] [mail_dir=full-path-to-mail-directory]
  3193.    [message=full-path-name-of-message-to-send] [CONT]
  3194.  
  3195. If either the recipient's email address is present or the "message="
  3196. argument is present, AEMail assumes that we are using AEMail as a "MailTo"
  3197. agent or you are trying to queue or send a message composed outside of
  3198. AEMail.  AEMail will load and immediately display the Compose message
  3199. window.
  3200.  
  3201. If the "message=" argument was used, you will be in the "edit" mode of the
  3202. compose screen.  You can either edit the supplied message or immediately
  3203. [Save in Pending], [Queue Message], [Send Message Now], or [Cancel
  3204. Message].  You can also perform any other action on the message including
  3205. adding headers, adding attachments, or adding your signature block (see
  3206. the Section VIII, Compose Message Window).
  3207.  
  3208. The message that the "message=" argument points to must be a complete
  3209. message with at least one header.  It is suggested that you include at
  3210. least a "To:  " and "Subject:  " header.  These should be followed with at
  3211. least one blank line before the body of the message.
  3212.  
  3213. If both the "mail address of the recipient" argument and the "message="
  3214. argument are used, the "mail address" will take precedence over the "To: "
  3215. header in the message.
  3216.  
  3217. The recipient's name in either the mailto argument or the To header in the
  3218. message referenced by the "message=" argument, can be a nickname present
  3219. in your Address Book.  This is a convenient way to send messages to groups
  3220. where you are periodically adding or deleting members from the group.
  3221. Just use the group nickname in the "To:  " address to send the message to
  3222. the entire group.
  3223.  
  3224. If the "message=" argument is not present but a recipient's email address
  3225. is present, you will enter the compose window in a "new" message mode.
  3226. You must compose a message or Cancel the operation in order to procede.
  3227.  
  3228. When you exit from the Compose window by clicking on one of the action
  3229. requesters at the bottom of the window, AEMail will terminate
  3230. automatically unless the "CONT" keyword was present in the argument
  3231. stream.  If "CONT" is used, AEMail will continue so that you can perform
  3232. other AEMail functions.  You will then have to quit using the "Quit..."
  3233. menu item in the "Project Menu".
  3234.  
  3235. The "config=" keyword parameter is used to specify a configuration file
  3236. other that the default s:aemail.cnfg file.  All pertanent data on the
  3237. AEMail configuration to be used will be in this file.  If you wish to
  3238. invoke AEMail from the shell and have it run with a different
  3239. configuration file, you can use the "config=" parameter to direct AEMail
  3240. to use this different configuration file on startup.  To use AEMail in
  3241. this manner, you could simply type:
  3242.  
  3243.     AEMAIL config=[name_of_configuration_file]
  3244.  
  3245. If the "config=" keyword parameter or the s:aemail.cnfg file are both not
  3246. present a default s:aemail.cnfg file will be created.  Of course, if this
  3247. happens, your normal configuration data will not be present (such as your
  3248. POP3 UserID, Password, POP Server name, or SMTP Server name) and your
  3249. normal mail directory will not be found unless the "mail_dir=" keyword
  3250. parameter described below is present.
  3251.  
  3252. If your normal configuration file is not s:aemail.cnfg and you wish to
  3253. execute AEMail from the shell (or as a "MailTo" agent), you should load
  3254. AEMail from the workbench using the icon specifying the configuration file
  3255. you want to use and then do a "Save As..." from the "Configuration" menu
  3256. item of the "Project" menu.  Specify "s:aemail.cnfg" in the Save As file
  3257. requester.  This will create a vaild s:aemail.cnfg file.
  3258.  
  3259. The "mail_dir=" is used to specify the mail directory for the user
  3260. specified in the config= parameter.  It corresponds to the MAIL_DIR= Tool
  3261. Type.  Normally, this is unnecessary (in fact, discouraged) if the
  3262. configuration file is present since the mail directory will be stored in
  3263. the configuration file.  You must specify a full path name if the
  3264. "mail_dir" parameter is used.  Be very careful in using this parameter
  3265. since it could change the mail directory specified in your configuration
  3266. file with undesireable results.
  3267.  
  3268. If AEMail is used as a "mailto:" agent for your browser and that browser
  3269. passes it's public screen name along with the userid, you can use the
  3270. keyword argument "pubscn=" to specify that public screen.  AEMail will
  3271. then bring the browser's screen to the front when AEMail terminates.  If
  3272. this argument is missing and the browser opens on it's own screen but does
  3273. not, itself, bring the screen to the front when it returns from the
  3274. "mailto" command, you might have to manually bring the browser's screen to
  3275. the front with the LEFT-AMIGA M key.
  3276.  
  3277. When you invoke AEMail from the shell with a email address parameter or a
  3278. "message=" argument, you normally will not be able to use any of the
  3279. AEMail menus or commands unless the "CONT" key word was used.  However,
  3280. AEMail will always check for Mail on your POP Server and for Queued
  3281. messages to send before displaying the Compose message screen (see initial
  3282. AEMail action below) and ask for configuration data if required parameters
  3283. are not present in the s:aemail.cnfg file or the config= configuration
  3284. file.
  3285.  
  3286. If you invoked AEMail from the shell without any parameters, AEMail will
  3287. behave the same as if it was invoked from the Workbench by clicking on
  3288. it's icon except that tool types will not be utilized and the
  3289. s:aemail.cnfg file will be used by default.  If you are a new user of
  3290. AEMail and do not have an s:aemail.cnfg file (you assigned a different
  3291. name and place for the configuration file), you can create one easily.
  3292. Bring up the primary user of AEMail from the Workbench (the user you want
  3293. to activate from the shell) and perform a "Configuratio/Save As" from the
  3294. "Project" menu.  When the file requester comes up, specify the "S:"
  3295. directory and "aemail.cnfg" as the file name.  Invoking from the Workbench
  3296. is described below.
  3297.  
  3298.                       Running AEMail in Offline Mode
  3299.                       ------------------------------
  3300.  
  3301. AEMail can be run either in an offline or online mode.  This means that
  3302. you do not have to be connected to your Internet provider when AEMail is
  3303. activated.  However, to actually receive or send mail via your Internet
  3304. provider, you must have your TCP/IP stack (AmiTCP, TermiteTCP, Miami, etc)
  3305. running and connected to your provider.  You can activate AEMail before
  3306. connecting to your provider or after; it makes no difference.
  3307.  
  3308. Both a convenient menu item and a command icon have been provided in
  3309. AEMail to start your TCP/IP stack ("TCP/IP/Start Net") after AEMail is up
  3310. and running provided a script can be used to make this connection. If
  3311. a script is not provided for this purpose, AEMail will iconify to allow
  3312. you to start your TCP/IP stack manually.  A menu item ("TCP/IP/Stop Net")
  3313. and command icon have also been provided to disconnect your network
  3314. connection.
  3315.  
  3316. To cause your TCP/IP stack to be executed manually, clear the script names
  3317. in the Configuration Setup Window, TCP/IP page.
  3318.  
  3319. Two command icons have been provided in the Command Icon tool bar to also
  3320. perform Starting and Terminating your TCP/IP Network Connection.
  3321.  
  3322. You can also automatically activate your Internet connection at program
  3323. startup by providing the AUTOCONNECT=YES Tool Type described above or by
  3324. checkmarking the "Automatic connection to Internet Provider on AEMail
  3325. Start Up" in the TCP/IP Page of the Configuration Setup Window.
  3326.  
  3327. WARNING:  for this to work, you will need to be able to activate your
  3328. TCP/IP stack automatically by a script.
  3329.  
  3330.                    Activating AEMail from the Workbench
  3331.                    ------------------------------------
  3332.  
  3333. To activate AEMail from the Workbench simply double click on the AEMail
  3334. Project icon.  You can also activate AEMail from the shell, but, if
  3335. activated in this manner, it will not have access to the configuration
  3336. information provided by the Tool Types.  It does, however, have access to
  3337. the configuration information in the specified AEMail configuration file
  3338. (either the default s:aemail.cnfg or the file specified with config= in
  3339. the shell calling argument).
  3340.  
  3341. AEMail opens on it's own 16 color Public Screen.  The Public Screen name
  3342. is "AEMAIL-1".  4 of the colors are defined by the first four colors of
  3343. the workbench screen.  The following 8 colors are pre-defined with the
  3344. following colors:  Red (13R, 0B, 0G), Green (0R, 15G, 0B), Blue (0R, 0G,
  3345. 15B), Magenta (15R, 0G, 15B), Yellow (15R, 15G, 0B), Orange (15R, 10G,
  3346. 0B), Brown (10R, 5G, 0B), and Purple (9R, 3G, 9B).  These colors have been
  3347. preset to provide a consistant color scheme for displaying icons and
  3348. folder tab colors.  Under consideration is the possibility of allowing
  3349. these colors to be user settable in the future.
  3350.  
  3351. Since multiple windows are opened by AEMail, the program opens on it's own
  3352. screen to allow uniformity in being able to push the screen to the back
  3353. (with all of it's member windows) and back again to the front.  The
  3354. LEFT-AMIGA-M key can be used for this purpose.
  3355.  
  3356. You can also iconify AEMail with an iconify bar on the Workbench screen.
  3357. A menu item has been provided to perform the iconify action.  When this
  3358. menu item is selected, the AEMail screen will disappear and a button bar
  3359. will appear on the Workbench screen with
  3360.  
  3361.     AEMail (Click on Close or with RMB to restore)
  3362.  
  3363. in the title.  When the iconified bar is selected, clicking either on the
  3364. close gadget or with the Right Mouse Button (RMB) will restore the AEMail
  3365. screen.
  3366.  
  3367. There is also a hotkey provided for iconifying AEMail.  This is
  3368. RIGHT-AMIGA-I.  This same hot key will also take AEMail out of iconify
  3369. mode.  The LEFT-AMIGA-I key will also accomplish this.
  3370.  
  3371. Periodically during the running of AEMail, the program will automatically
  3372. switch to the workbench screen for executing certain functions and then
  3373. switch back when the function is complete.
  3374.  
  3375. The first thing AEMail does when it is activated is to check to see that
  3376. certain configuration information has been provided.  The necessary items
  3377. are:
  3378.  
  3379.     POP3 UserID
  3380.     Password
  3381.     From Addr (your email address)
  3382.     POP Server
  3383.     SMTP Server
  3384.     Domain Name
  3385.     Edit Call
  3386.  
  3387. If these items have not be provided, the following requester will be
  3388. displayed:
  3389.  
  3390.     The following Configuration items are empty
  3391.  
  3392.     [list of empty items]
  3393.  
  3394.     They are required items!
  3395.  
  3396.  
  3397. If this requester is displayed, you will be given the following choices:
  3398.  
  3399.            [Configure AEMAIL now]               [Cancel AEMAIL]
  3400.  
  3401. If you were to click on [Cancel AEMAIL], AEMail will terminate.  You can
  3402. not proceed any further until you have entered these items with the
  3403. Configuration Setup Window or by providing them as Tool Types.
  3404.  
  3405. Clicking on the [Configure AEMAIL now] will bring up the Configuration
  3406. Setup Window which was described previously.
  3407.  
  3408. If the PASSPROTECT=YES Tool Type was provided (registered users only) the
  3409. following window will be displayed:
  3410.  
  3411.                 |========================================|
  3412.                 |0|Enter Password                        |
  3413.                 |----------------------------------------|
  3414.                 |                                        |
  3415.                 |     Enter your new password below      |
  3416.                 |                                        |
  3417.                 |  [                                  ]  |
  3418.                 |                                        |
  3419.                 |                                        |
  3420.                 |                                        |
  3421.                 |  [START OVER]            [  CANCEL  ]  |
  3422.                 |________________________________________|
  3423.  
  3424.  
  3425. You must enter your password before you can procede.  You will be allowed
  3426. three attempts to enter a correct password.  If the correct password has
  3427. not been entered after three attempts, AEMail will terminate.  If the
  3428. password is correct, AEMail will continue.
  3429.  
  3430. NOTE: since activating the password protection is done by a Tool Type,
  3431. password protection is not available when you activate AEMail from the
  3432. shell.
  3433.  
  3434. If this is the first time AEMail has been executed after a new version has
  3435. been installed, the "Send AEMail Notification Request" will appear.  See
  3436. "REGISTRATION" under Section II, SYSTEM REQUIREMENTS for a description of
  3437. the Notification Request.
  3438.  
  3439. After verifying that required configuration information has been provided
  3440. and that correct password has been entered (if required), AEMail will
  3441. check to see if you are connected to your Internet provider.  If you are,
  3442. connection will be made to your POP server to see if there are any
  3443. messages available on the server in your mail box.  If there are, the
  3444. following requester will appear:
  3445.  
  3446.                   n Messages Available on the POP Server
  3447.  
  3448.                 Do you wish to receive these messages now?
  3449.  
  3450. If you click on the [YES] button, those message will be retrieved at this
  3451. point.  See the RETRIEVE MESSAGES command described in Section VI.
  3452. COMMAND ICON STRIP for details on this process.
  3453.  
  3454. If you click on [NO], no message retrieval will take place at this time.
  3455. You will need to retrieve these messages later using the RETRIEVE MESSAGES
  3456. command icon.
  3457.  
  3458. After AEMail checks to see if any messages are available on the POP
  3459. Server, it also checks to see if any messages are in the QUEUED folder
  3460. (messages queued to be sent).  If there are, the following requester will
  3461. appear:
  3462.  
  3463.                   You have n messages queued to be sent
  3464.  
  3465.                  Do you wish to send these messages now?
  3466.  
  3467. If you click on the [YES] button, all of the messages in the QUEUED folder
  3468. will be sent immediately.  This is the same as selecting the "Send Queued
  3469. Mail" item under the "Project" menu or selecting the QUEUED FOLDER and
  3470. clicking on the "Send Message Immediately" command icon (see Sections VI.
  3471. Command Icon Strip and VII.  AEMAIL MENUS below).
  3472.  
  3473. If you click on [NO], the queued messages will not be sent at this time.
  3474. You will need to send these messages later using either the "Send Queued
  3475. Mail" item under the "Project" menu or selecting the QUEUED FOLDER and
  3476. clicking on the "Send Message Immediately" command icon.
  3477.  
  3478. If you successfully connected at program startup the following message
  3479. will appear in the Title bar of the AEMail screen:
  3480.  
  3481.     TCP/IP session started with [Your-POP-Server-Name]
  3482.  
  3483. If you were not connected the following message will appear in the Title
  3484. bar:
  3485.  
  3486.     Not Connected to [Your-POP-Server-Name] Host
  3487.  
  3488. You can disable either or both the POP mail check or the queued mail check
  3489. at startup by checkmarking the appropriate items in the TCP/IP page of the
  3490. Configuration Setup Window.
  3491.  
  3492. When AEMail first starts, three windows are opened in horizontal bands on
  3493. the AEMail screen.  A window is displayed just below the screen menu/title
  3494. bar and provides a contextual help title bar and a Command Icon Tool Bar.
  3495. This Tool Bar provides icons for accessing the major functions of AEMail
  3496. and consists (from left to right) of the following icons:  Display Folder
  3497. List, Display Address Book, Retrieve Messages, Display Previous Message,
  3498. Display Previous Folder's Message List, Display Current Folder's Message
  3499. List, Display Next Folder's Message List, Display Next Message, Compose a
  3500. Message, Queue Message for Later Delivery, Send Message Immediately, Save
  3501. Message To File, Print, Delete/Undelete Message, Copy Messages, Transfer
  3502. Messages, Start TCP/IP Network Connection and Terminate TCP/IP Network
  3503. Connection.
  3504.  
  3505. The window below the command icon tool bar contains a "folder strip" set
  3506. of icons.  An icon is provided for each folder with a colored "tab" to
  3507. indicate the type of folder (of the user's own choosing).
  3508.  
  3509. Within each folder icon is a short name (not exceeding 9 characters) for
  3510. that folder.  Below this is the total number of messages minus any deleted
  3511. messages.  It may be followed by the number of un-read messages in
  3512. parenthesis.  If there are unread messages, both numbers will be displayed
  3513. in red.  These messages counts will be updated as messages are added or
  3514. deleted from the folders.
  3515.  
  3516. The height of the folder strip is defined by the font size that is used
  3517. for the folder name and the folder contents.  The font and font size that
  3518. is used can be selected by the user with either the FLDRFONT= or
  3519. FLDRFONTSZ= Tool Types on the Font Page on the Configuration Setup Window.
  3520. The folder icons will adjust accordingly.
  3521.  
  3522. Four pre-defined folders are provided:  "INBOX" for holding retrieved
  3523. messages, "PENDING" which holds messages that the user is currently
  3524. composing and has not decided to send as yet, "QUEUED" which holds
  3525. completed messages for later transmission, and "SENT" which holds messages
  3526. that have been sent and accepted by the SMTP Server.  Since these folders
  3527. must always be present, you can not delete or change the name of these
  3528. folders.
  3529.  
  3530. A facility has been provided to allow the user to add as many additional
  3531. folders of his own choosing that he wants to the list of folders.
  3532.  
  3533. As each new folder is created, an icon will be created and placed next to
  3534. the last folder icon.  Any number of folders can be created and the
  3535. "folder strip" has the ability to scroll horizontally so that all of the
  3536. folder icons can be viewed and accessed.
  3537.  
  3538. The displayed folder list (activated by using the Display Folder List icon
  3539. in the Command Icon Tool Bar) will be in the same order as the folder
  3540. icons in the folder strip.  You can change the order of both the folder
  3541. icons and the list of folders by using the Move...  menu item under the
  3542. Folders menu.
  3543.  
  3544. You can use the menu items "Transfer..." and "Copy..." under the MESSAGE
  3545. menu to transfer or copy messages between folders.
  3546.  
  3547. The last window is placed below the "folder strip" and is used to display
  3548. either folder lists, address books, message lists, or messages themselves.
  3549. If a non-interlaced screen is provided, the message and address book
  3550. displays will start below the Command Icon Tool Bar (overlaying the folder
  3551. strip) rather than below the folder strip.  This is done to provide more
  3552. room for the message or address book display since the number of
  3553. displayable lines is limited.
  3554.  
  3555. Other windows are also provided which cover the entire screen below the
  3556. title bar for the purpose of providing configuration information and for
  3557. composing messages.
  3558.  
  3559. Each of the windows is described in detail in the WINDOW section below.
  3560.  
  3561. While the Command Icon Tool Bar and the folder strip are being displayed,
  3562. a contextual help line is provided in the Command Icon Tool Bar window
  3563. title bar below the screen's title bar.  As you pass the mouse cursor over
  3564. any command or folder icon, a description of that command or folder will
  3565. be displayed in the window title bar.  The main window menu bar should
  3566. also be active whenever the mouse pointer moves to the "folder strip" or
  3567. above.
  3568.  
  3569. All command and folder icons are surrounded by a raised box.  Whenever a
  3570. command or folder is selected, the box will become depressed.
  3571.  
  3572. When AEMail is first activated and you are online and have mail and accept
  3573. it's transfer, the message list for the INBOX folder will be displayed.
  3574. As each mail message is received you will see it added to the message list
  3575. of the INBOX.
  3576.  
  3577. If you are offline or there is no mail or mail is not being checked, the
  3578. folder list will be displayed.  Double clicking on either the name of a
  3579. folder in the list or one of the folder icons will cause the message list
  3580. for that folder to be displayed.
  3581.  
  3582. Double clicking on a message in the message list will cause that
  3583. particular message to be displayed.
  3584.  
  3585. If you have selected a time increment in the TCP/IP page of the
  3586. Configuration Setup Window (the default is 2 minutes), a background
  3587. process will be started which checks your POP server every few minutes (as
  3588. specified by the interval) for messages.  If there are any messages, the
  3589. following requester will pop up:
  3590.  
  3591.  
  3592.                              YOU HAVE MAIL!!
  3593.  
  3594.                   n Messages available on the POP Server
  3595.  
  3596.                 Do you wish to receive these messages now?
  3597.  
  3598.  
  3599. Replying [YES] to the above requester will start the retrieval of the
  3600. messages.  This requester will only pop up when you are not in the middle
  3601. of some function such as composing a message, transferring or saving a
  3602. message, printing a message, or performing configuration changes.  It will
  3603. pop up on the Workbench screen if you have AEMail iconified.
  3604.  
  3605. NOTE:  if you did not specify that you wanted messages deleted from your
  3606. POP server as you transferred them to your Amiga, the "YOU HAVE MAIL"
  3607. requester will pop up each time the system checks for mail.
  3608.  
  3609.  
  3610.                          Getting HELP with AEMail
  3611.                          ------------------------
  3612.  
  3613. AEMail has a very extensive context sensitive help system.  Some help is
  3614. provided automatically.  As you pass the cursor over the Command Icon Tool
  3615. bar, the description of the icons appear in the window title bar above the
  3616. icons.  Likewise, as you pass the cursor over the folder icons, the folder
  3617. description also appears in the window title bar.
  3618.  
  3619. In addition, pressing the [Help] key will bring up a description of what
  3620. you are currently seeing or trying to do.  This help is taken from the
  3621. "AEMail.guide" file which normally is located in the AEMail2:documentation
  3622. directory.  If you located the guide file somewhere else you will have to
  3623. use the Tool Type "HELP=" to identify the location of the guide file.
  3624. This must be done manually in each of your AEMail project icons.
  3625.  
  3626. If you did not choose to install the current AEMail.guide file, you will
  3627. not be able to use the [Help] key.  In fact you will receive a requester
  3628. that looks like this when you first load AEMail:
  3629.  
  3630.                      Error: (AG) Can't Open database!
  3631.  
  3632.                                 [Continue]
  3633.  
  3634. Clicking on [Continue] will allow you to continue running AEMail but the
  3635. [Help] key will be effectively disabled.  If you are using an old
  3636. "AEMail.guide" file you may get a requester saying that a particular help
  3637. page could not be found.  Also, the information on the page being
  3638. displayed may not be up to date.
  3639.  
  3640. You can receive help with any of the menus as well as with any of the
  3641. windows that are being displayed.  To receive help with a menu or menu
  3642. item, press the [Help] key when you hold down the Right Mouse button.
  3643. Help will be displayed for the menu or menu item that is currently
  3644. highlighted.
  3645.  
  3646. Also, certain key combinations will display different "AEMail.guide"
  3647. pages.  If you press either Shift keys when you press [Help], the main
  3648. guide table of contents will be displayed.
  3649.  
  3650. If you are in a string entry gadget, pressing either [Alt] keys with the
  3651. [Help] key will display the page describing "Editing String Entry
  3652. Gadgets".
  3653.  
  3654. WARNING:  Because of a bug in ClassAct, some string gadgets will not be
  3655. reactivated after the help page is displayed.  You will have to click into
  3656. the gadget to reactivate it.
  3657.  
  3658.                      USING AEMail AS A "MailTo" AGENT
  3659.                      --------------------------------
  3660.  
  3661. A number of Amiga web Browsers allow you to select an external Mail agent
  3662. to be used for sending email when a "mailto:" HTML link is specified.
  3663. AEMail can be used as such an external mail agent.
  3664.  
  3665. There are two methods in which AEMail can be used as an external Mail
  3666. agent for sending "mailto:" email messages.  The first method is to call
  3667. AEMail directly.  This method has the restriction that AEMail must NOT be
  3668. running when you start up your browser.  When you click on the "mailto:"
  3669. link, AEMail will be loaded, the Compose message window will be displayed,
  3670. you will then be able to compose and send the message, and AEMail will
  3671. terminate.
  3672.  
  3673. The second method is to use an ARexx script to call AEMail for composing
  3674. and sending your email.  With this method AEMail can be running in the
  3675. background and is entered each time you want to compose and send a
  3676. message.  When the ARexx script is used, you can also receive email while
  3677. your browser is running.  A generic ARexx script is descibed below, but a
  3678. more sophisticated one called "mailto.aem" is provided in the AEMail ARexx
  3679. directory.  If you use this script you should move it to the REXX:
  3680. directory.
  3681.  
  3682. To use either method, set the "mailto" function to call an external
  3683. program.
  3684.  
  3685.                     Mailto by Calling AEMail Directly
  3686.                     ---------------------------------
  3687.  
  3688. On the configuration setup for your browser specify AEMail as your
  3689. "mailto:" agent by using the full path name of AEMail and the token for
  3690. specifying the "mailto:" email address.
  3691.  
  3692. As an example, for AWeb-II you can specify the following:
  3693.  
  3694.     AEMail2:AEMail %e
  3695.  
  3696. You do this by bringing up the Network Settings menu item under Settings.
  3697. On the display click on the Mail/News tab and then the Mail tab.
  3698.  
  3699. In the display, checkmark "Use external mailer" and the Command and
  3700. Argument string gadgets will become unghosted.  Enter
  3701.  
  3702.     AEMail2:AEMail
  3703.  
  3704. on the Command line, and
  3705.  
  3706.     %e
  3707.  
  3708. on the Argument line
  3709.  
  3710. Be sure and save your AWeb-II settings once you make the change.
  3711.  
  3712. Other browsers, if they use this capability, may have a different way to
  3713. specify the "mailto" user agent and the token for specifying where to
  3714. place the email address.  The token may change from version to version of
  3715. your browser.  Consult your browser documentation for how to do this.
  3716.  
  3717. The documentation for IBrowse, unfortunately, does not provide any
  3718. information on how to set up an external "mailto:" agent.  However it can
  3719. be done.  Follow these steps for IBrowse versions before 2.x:
  3720.  
  3721.     Select the Preferences menu in IBrowse
  3722.     Select Network
  3723.     Select "Email & Telnet" tab
  3724.     Under "Mailto:" Set the External mode
  3725.     For the command give the full path name of the AEMail program and
  3726.         follow it with %h
  3727.  
  3728.     example:  AEMail2:AEMail %h
  3729.  
  3730.     Select O.K.
  3731.  
  3732.     Be sure to "Save Settings" under the Preferences menu
  3733.  
  3734. The display used in IBrowse version 2.1 and above is slightly different.
  3735. The menu item that you use is Preferences/Settings.  Instead of tabs it
  3736. has a list of items on the left of the Preferences/Settings display.
  3737. Under Network you need to expand the list by clicking on the [+].  You
  3738. will now see the "Email & Telnet" on the list and the [+] will become [-].
  3739.  
  3740. Click on "Email & Telnet" and you will see a similar display to that used
  3741. in 1.x shown on the right.  Continue as you would with earlier versions of
  3742. IBrowse.
  3743.  
  3744. SPECIAL NOTE:  In IBrowse 2.1 the "Command" string gadget remains ghosted
  3745. which means that with 2.1 you CAN NOT specify an external "mailto:" agent.
  3746. Hopefully this will be corrected in later versions of IBrowse.
  3747.  
  3748. In order for the "mailto:" agent to work properly, AEMail must NOT be
  3749. running when you start up your browser.  When you click on the "mailto:"
  3750. link, AEMail will be loaded, the Compose message window will be displayed,
  3751. you will then be able to compose and send the message, and AEMail will
  3752. terminate.
  3753.  
  3754. If you have a custom configuration file (other than s:aemail.cnfg), you
  3755. should also add the argument "config=name-of-config-file" to the "mailto"
  3756. calling argument.  As an example, using IBrowse:
  3757.  
  3758.     AEMail2:AEMail %h config=name-of-file
  3759.  
  3760.  
  3761.                             MailTo Using ARexx
  3762.                             ------------------
  3763.  
  3764. Rather than use the "mailto:" capability described above, you can also
  3765. call an ARexx script which calls the Compose function of AEMail.  Such a
  3766. script for any browser would be as follows:
  3767.  
  3768.     /* Arexx AEMail Mailto Compose */
  3769.     OPTIONS RESULTS
  3770.     parse arg userid screen a
  3771.  
  3772.     ADDRESS AEMAIL1
  3773.     SCREENTOFRONT AEMAIL
  3774.     COMPOSE MAILTO userid
  3775.     SCREENTOFRONT screen
  3776.     if (result = 0) then okay1 "Bad Public Screen"
  3777.     exit
  3778.  
  3779. This script requires AEMail to be running when the script is called.  A
  3780. more sophisticated script which is contained in the AEMail ARexx directory
  3781. called "mailto.aem" automatically loads AEMail if it was not already
  3782. loaded.
  3783.  
  3784. The above script is saved in the REXX:  directory as "mailto.aem".
  3785.  
  3786. The call that is placed on the command line in the "Mailto:" in IBROWSE
  3787. would be:
  3788.  
  3789.     rx mailto.aem %h %p
  3790.  
  3791. If you have not moved or saved the "mailto.aem" script in the REXX:
  3792. directory you can call it from the AEMail ARexx directory by specifying:
  3793.  
  3794.     rx AEMail2:ARexx/mailto.aem %h %p
  3795.  
  3796. Note the use of the full path name for calling the "mailto.aem" script.
  3797.  
  3798. The advantage of using ARexx is that AEMail can be running while you are
  3799. doing your web browsing.  If you happen to receive email during this time,
  3800. a requester will then pop up saying that you have mail and asking if you
  3801. want to read it.
  3802.  
  3803. In the IBrowse ARexx call above notice the argument %p.  This is the token
  3804. that passes the IBrowse screen name to AEMail.  This allows AEMail to
  3805. bring the IBrowse screen to the front after the message is sent (or
  3806. queued).
  3807.  
  3808. PLEASE NOTE:  There is a problem with IBrowse 2.1 in that you can not
  3809. enter an external mailer.
  3810.  
  3811. With AWeb-II you would enter rx on the command line and
  3812.  
  3813.     mailto.aem %e %n
  3814.  
  3815. if "mailto.aem" is in the REXX: directory or, if calling from the AEMail
  3816. ARexx directory:
  3817.  
  3818.     AEMAIL2:ARexx/mailto.aem %e %n
  3819.  
  3820. on the argument line.
  3821.  
  3822. Notice the difference between the tokens in IBrowse and AWeb-II.  %h and
  3823. %p are used for the email and screen tokens in IBrowse; %e and %n are used
  3824. for these tokens in AWeb-II.
  3825.  
  3826.                          Using Keyboard Hot Keys
  3827.                          -----------------------
  3828.  
  3829. While AEMail was designed to utilize the mouse for activating commands,
  3830. there are a number of keyboard hot keys that can be used to activate
  3831. commands on the command strip without using the mouse.  There are also
  3832. keyboard actions for moving the various listviews up and down.  Also, most
  3833. of the menu items can use a keyboard hot keys for activating them.
  3834.  
  3835. A key command has been assigned to each of the command strip icons.  When
  3836. a menu item duplicates the action of a command on the command strip, the
  3837. menu keyboard hot key is used.  A summary of the keyboard action that can
  3838. be taken for each of the commands on the command icon strip is given
  3839. below:
  3840.  
  3841.     Command Strip Icon                          Key Code
  3842.     ------------------                          --------
  3843.  
  3844.     Display Folder List                         f
  3845.     Display Address Book                        a
  3846.     Retrieve Messages                           Right Amiga m
  3847.     Display Previous Message                    Cursor Left
  3848.     Display Previous Folder's Message List      Shift Cursor Left
  3849.     Display Current Folder's Message List       =
  3850.     Display Next Folder's Message List          Shift Cursor Right
  3851.     Display Next Message                        Cursor Right
  3852.     Compose A Message
  3853.         Compose a new message                   Right Amiga n
  3854.         Reply to current message                Right Amiga r
  3855.         Forward current message                 Right Amiga >
  3856.         Edit current message                    Right Amiga e
  3857.     Queue Message For Later Delivery            q
  3858.     Send Message Immediately                    s
  3859.     Export (Save) Message To File               Right Amiga v
  3860.     Print                                       Right Amiga p
  3861.     Delete/Undelete Message                     x, Right Amiga x
  3862.     Copy Messages to a New Folder               Right Amiga =
  3863.     Transfer Messages to a New Folder           Right Amiga -
  3864.     Start TCP/IP Network Connection             Right Amiga t
  3865.     Terminate TCP/IP Network Connection         Right Amiga h
  3866.  
  3867. These key codes are also shown on the icon information line that appears
  3868. when you pass the mouse over the command icons.
  3869.  
  3870. The "=" key also toggles the message selection indicator (*)
  3871.  
  3872. When you are displaying a list, the following keys move the listview:
  3873.  
  3874.     "Cursor Down" moves the listview one row down.
  3875.     "Cursor Up" moves the listview one row up.
  3876.     "Home" or "ALT Cursor Up" moves the listview to the top.
  3877.     "End" or "ALT Cursor Down" moves the listview to the botton.
  3878.     "PgUp" or "Shift Cursor Up" pages the listview one "page" up.  The
  3879.         top line of the previous page will be displayed as the bottom
  3880.         line of the new page.
  3881.     "PgDn" or "Shift Cursor Down" pages the list view one "page" down.
  3882.         The bottom line of the previous page will be displayed as the
  3883.         top line of the new page.
  3884.     The cursor up/down keys on the keypad will have the same action as
  3885.         the normal cursor keys with the exception of the shift and ALT
  3886.         feature.
  3887.  
  3888. Since the cursor keys are used to move the listview up or down, the space
  3889. bar is used to manipulate the selected row on the listview.  The action of
  3890. the the space bar in conjuction with control keys is as follows:
  3891.  
  3892.     Space Bar               Selects the next item in the list
  3893.     Shift Space Bar         Selects the previous item in the list
  3894.     Left Amiga Space Bar    Selects the first item in the list
  3895.     Right Amiga Space Bar   Selects the last item in the list
  3896.  
  3897. The item selected will be highlighted.  If it was previously selected with
  3898. the "*" indicator, it will be de-selected ("*" removed); otherwise it will
  3899. be selected with an "*".
  3900.  
  3901. When one of the above sets of keys are pressed, the current item is
  3902. unselected ("*" is toggled).  To keep the current item selected, press the
  3903. "Ctrl" key at the same time as you press the appropriate key combination.
  3904. Always remember to press the control keys (shift, left Amiga, right Amiga,
  3905. or ctrl) before you press the space bar.
  3906.  
  3907. Pressing the RETURN key when a row is highlighted is the same as double
  3908. clicking on that item.  In other words, if you are displaying the folder
  3909. list and you hit the RETURN key, the message list for the highlighted
  3910. folder will be displayed.
  3911.  
  3912. Unfortunately, gadgets in subsiderary windows do not have key codes
  3913. assigned to them at this time.  You can activate requester gadgets however
  3914. by pressing "Left Amiga v" for the left most gadget and "Left Amiga b" for
  3915. the right most gadget.  Center gadgets, if present, do not have an assigned
  3916. key code.  Requesters with this action are only those that appear at the
  3917. left most top corner of the screen.
  3918.  
  3919.                        Editing String Entry Gadgets
  3920.                        ----------------------------
  3921.  
  3922. A number of windows in AEMail use string entry gadgets for entering data.
  3923. These gadgets look like long rectangles with a cursor which allows you to
  3924. type in the data you want.  There are a number of special key combinations
  3925. that can aid you in the entry process.  These are:
  3926.  
  3927.     Cursor Left         Move cursor to previous character
  3928.     Shift Cursor Left   Move cursor to the beginning of the string
  3929.     Cursor Right        Move cursor to next character
  3930.     Shift Cursor Right  Move cursor to the end of the string
  3931.     Del                 Delete the character under the cursor
  3932.     Shift Del           Delete from the character under the cursor to the
  3933.                         end of the line
  3934.     Backspace           Delete the character to the left of the cursor
  3935.     Shift Backspace     Delete from the character to the left of the cursor
  3936.                         to the start of the line
  3937.     Return or Enter     Terminate input and deactivate the gadget
  3938.     Tab                 Terminate input and activate the next string gadget
  3939.     Shift Tab           Terminate input and activate the previous string
  3940.                         gadget
  3941.     Right Amiga c       Copy the string to the current clipboard unit
  3942.                         (either c or C will work)
  3943.     Right Amiga d       Copy default value to the string.  Only works on
  3944.                         the Configuration Setup Window (Note:  either d or
  3945.                         D will work).
  3946.     Right Amiga f       Calls the file requester in strings that use file
  3947.                         requesters.  Only works on the Configuration
  3948.                         Setup Window (Note: either f or F will work).
  3949.     Right Amiga p       Used only in the Identity Page of the
  3950.                         Configuration  Setup  Window with the POP3 UserID:
  3951.                         string to call Set Password (Note:  either p or P
  3952.                         will work).
  3953.     Right Amiga q       Undo (cancel) the last editing change to the string
  3954.                         (Note: either q or Q will work)
  3955.     Right Amiga u       Change the current clipboard unit
  3956.     Right Amiga U       Display a list of the current active clipboard
  3957.                         units and their contents
  3958.     Right Amiga v       Paste the contents of the current clipboard unit
  3959.                         to the string (either v or V will work)
  3960.     Right Amiga x       Clears the string (either x or X will work)
  3961.  
  3962. In addition, the following editing functions are available if the IControl
  3963. preferences editor has "Text Gadget Filter" selected.  Note: either the
  3964. upper or lower case alphabetic character will work.
  3965.  
  3966.     Ctrl A              Jump cursor to the start of the string
  3967.     Ctrl H              Delete the character to the left of the cursor
  3968.     Ctrl K              Delete from the character under the cursor to the
  3969.                         end of the line
  3970.     Ctrl M              Same as Return or Enter
  3971.     Ctrl W              Delete the previous word
  3972.     Ctrl U              Delete from the character to the left of the cursor
  3973.                         to the start of the line
  3974.     Ctrl X              Clears the string
  3975.     Ctrl Z              Jump cursor to end of the string.
  3976.  
  3977. All of the above characteristics of string editing are standard with the
  3978. Amiga with the exception of those keystrokes that involve the clipboard,
  3979. file requesters, and default values.
  3980.  
  3981. The clipboard functions are specific to AEMail, although other programs
  3982. may have similar functions using the same key combinations built into
  3983. them.  For more information on using the clipboard see "Using the
  3984. Clipboard with AEMail" below.
  3985.  
  3986. The default, file requester, and "Set Password" functions are also
  3987. specific to AEMail.
  3988.  
  3989.  
  3990.                       Using the Clipboard with AEMail
  3991.                       -------------------------------
  3992.  
  3993. On the Amiga, the clipboard provides a facility for passing information
  3994. from one program to another, or for saving information for re-use in the
  3995. same program.  AEMail utilizes the clipboard in several ways:
  3996.  
  3997. Each string entry gadget has the ability of copying the current contents
  3998. of the string to the clipboard or of pasting the contents of the clipboard
  3999. to the string gadget.  In that manner information can be saved and re-used
  4000. at a later time.
  4001.  
  4002. You can also obtain a line from a message, edit it, and save that to the
  4003. clipboard; or you can save the entire contents of the message body to the
  4004. clipboard.  If you are using an editor that also supports the clipboard,
  4005. you can retrieve information that you previously copied to the clipboard
  4006. and insert it into a message you are composing.
  4007.  
  4008. If your browser supports the clipboard, you can use the above method to
  4009. capture a URL that is embedded in a message and then paste it into the
  4010. browser's URL string.  There is also a facility to directly transfer an
  4011. email or web (URL) address to a browser or within AEMail by the use of a
  4012. function key and an ARexx script.
  4013.  
  4014. AEMail supports the use of multiple clipboards (up to 256 separate
  4015. clipboard units), so different information can be copied to separate
  4016. clipboard units and retrieved later.  If other external programs also
  4017. support multiple clipboard units you can pass separate pieces of
  4018. information to those programs.
  4019.  
  4020. With each string entry gadget in AEMail you can use "Right Amiga C" or "Right
  4021. Amiga c" (either upper or lower case c) to copy the information from a
  4022. string to a clipboard unit.  Likewise, you can use "Right Amiga V" or "Right
  4023. Amiga v" (upper or lower case v) to paste the information into the string
  4024. gadget.  This works with all string gadgets except the "Enter Password" or
  4025. "Set Password" (in the Identity page of the Configuration Setup Window)
  4026. string gadgets.
  4027.  
  4028. Generally speaking when you use the paste operation in a string gadget, it
  4029. will replace the contents of the string gadget with the contents of the
  4030. clipboard.  The exception to this is with the To:, cc:, and bcc:  string
  4031. gadgets on the Compose Message Window and when editing a string that is
  4032. captured from a message (see below).
  4033.  
  4034. For the To:, cc:, and bcc:  string gadgets, the clipboard data will be
  4035. ADDED to what was previously in the string gadget.  Any added email
  4036. addresses added with the paste operation will be separated from the
  4037. previous addresses with a comma.
  4038.  
  4039. If  you  double  click  on  a  line in a message that is being displayed, a
  4040. special window will open at the top of the screen which looks like this:
  4041.  
  4042.  
  4043. |=========================================================================|
  4044. |o| Edit and save message line to clipboard; set ARexx variable
  4045. |-------------------------------------------------------------------------|
  4046. |                                                                         |
  4047. | [Message line appears here                                            ] |
  4048. |                                                                         |
  4049. | [ SAVE CLIP ]              [CHANGE CLIP UNIT]              [  CANCEL  ] |
  4050. |_________________________________________________________________________|
  4051.  
  4052.  
  4053. You can use the copy and paste to and from the clipboard unit while you
  4054. are editing within the string entry gadget above.  However, if you paste
  4055. to the string, the data in the clipboard will be inserted at your cursor
  4056. position.  This is different from all other string entry gadgets where the
  4057. pasted data replaces whatever was in the string gadget before.  This
  4058. feature for the editing and saving of a line from a message can facilitate
  4059. building a clipboard line from different lines in the message.  To do
  4060. this, edit the first line so that just the portion that you want added or
  4061. inserted to a second line remains in the string.  Copy this to a clipboard
  4062. unit ([SAVE CLIP]).  Then double click on a second line.  Position the
  4063. cursor where you want the first clipboard data to appear and perform the
  4064. paste operation.  The previously copied data will be inserted at that
  4065. point.
  4066.  
  4067. When you click on either the [SAVE CLIP], [CANCEL], or the close gadget at
  4068. the top of the window, the edit window will disappear.  Clicking on the
  4069. [SAVE CLIP] will save the edited string to the current clipboard unit and
  4070. clicking on the [CANCEL] or close gadget will exit without saving.
  4071.  
  4072. Warning:  using the copy function from within the string gadget with
  4073. "Right Amiga c" will always copy the current contents of the string to the
  4074. clipboard whether or not you later click on the [CANCEL] or the close
  4075. gadget.  There is no way to undo this operation.  However, using the copy
  4076. function from within the string gadget will not close the edit window.
  4077.  
  4078. Clicking on the [CHANGE CLIP UNIT] in the edit window or typing "Right Amiga
  4079. u" (lower case u only) from any string gadget will bring up a special
  4080. window that will allow you to change the current clipboard unit.  This
  4081. window looks like this:
  4082.  
  4083.  
  4084.                          |=======================|
  4085.                          |o|Enter Clipboard Unit |
  4086.                          |-----------------------|
  4087.                          |                       |
  4088.                          | [         ] (0 - 255) |
  4089.                          |                       |
  4090.                          | [  OK  ]     [CANCEL] |
  4091.                          |_______________________|
  4092.  
  4093.  
  4094. You can enter any clipboard unit between 0 or 255 in the numeric gadget.
  4095. If you type RETURN after entering the number or click on [OK], the
  4096. clipboard unit you entered will become the new clipboard unit and the
  4097. window will close.  Clicking on the [CANCEL] gadget or the close gadget
  4098. will close the window without changing the current clipboard unit.
  4099.  
  4100. Since you may have data stored in multiple clipboard units and may forget
  4101. which clipboard unit has what data, another feature has been provided.  If
  4102. you type "Right Amiga U" (upper case U - shift and u) while you are editing
  4103. a string, the Clipboard Display window will be shown which looks like this:
  4104.  
  4105.  
  4106.                |===========================================|
  4107.                |o| Contents of Clip List                   |
  4108.                |-------------------------------------------|
  4109.                | Clip Contents                             |
  4110.                | ========================================= |
  4111.                | |  0 Contents of clip 0               | | |
  4112.                | |  2 Contents of clip 2               | | |
  4113.                | |                                     | | |
  4114.                | |                                     | | |
  4115.                | |                                     | | |
  4116.                | ========================================= |
  4117.                |                                           |
  4118.                | [  OK  ]     [NEW CLIP UNIT]     [CANCEL] |
  4119.                |___________________________________________|
  4120.  
  4121.  
  4122. This shows all of the clipboard units that have data stored in them and
  4123. the contents of each clipboard unit in a listview.  Clipboard units may be
  4124. skipped as shown in the illustration above.  Since the contents of a
  4125. clipboard can be a complete file, the first non-blank line will be
  4126. displayed and leading spaces will be stripped.  Only text clips will be
  4127. displayed.  Only 40 characters can be displayed.  If the line is longer
  4128. than 40 characters, the first 30 characters will be shown followed by
  4129. three periods and the last 7 characters.
  4130.  
  4131. Only clips with data will be shown.  The current clipboard unit will be
  4132. highlighted if it contains data.  Since it is possible to have a clipboard
  4133. unit assigned WITHOUT any data, you may see none of the units highlighted.
  4134. You can change to one of the clipboard units shown by clicking on it (it
  4135. will become highlighted) and then clicking on [OK].  You can also change to
  4136. a clipboard unit not shown by clicking on [NEW CLIP UNIT].  [CANCEL] and
  4137. the close gadget will close the window without any changes taking place.
  4138.  
  4139. A further feature of this window is to provide an automatic paste
  4140. capability by double clicking on one of the units being displayed.  That
  4141. will automatically paste the contents of the selected unit to the string.
  4142. If the selected clip is a file, only the first non-blank line will be
  4143. pasted and leading spaces will be stripped.  The "Right Amiga V" method of
  4144. pasting from within a string gadget also has this feature for multiple
  4145. line files.
  4146.  
  4147. Another clipboard feature of AEMail is the ability to save the body of
  4148. messages and text attachments to the clipboard.  When you click on the
  4149. [SAVE TEXT] or [ATTACHMENT] button when you are displaying a message you
  4150. will be given the chance to save the text as a CLIP and also to change the
  4151. clipboard unit.  See the "Message Display Window" under VIII. AEMAIL
  4152. WINDOWS for a description of the requesters that appear to do this.
  4153.  
  4154.  
  4155.             Using Web and Email addresses embedded in messages
  4156.             --------------------------------------------------
  4157.  
  4158. If a message you have received contains a web address you can capture that
  4159. address, copy it to the clipboard, or actually call your web browser to
  4160. display the web page directly.
  4161.  
  4162. You can also capture email addresses embedded in a message, compose a
  4163. message to be directed to that address, or add that address to your
  4164. address book.
  4165.  
  4166. The method used to do this in AEMail is similar to that used in the
  4167. previous section which described the use of the clipboard.  We combine
  4168. that with the help of some pre-defined ARexx scripts.
  4169.  
  4170. Two event exits have also been provided to directly call ARexx scripts
  4171. when you double click on either the web or email address (see below).
  4172.  
  4173. If a message contains an email address (determined by the @ between
  4174. adjoining strings) or a web address (determined by www.  or http:  within
  4175. the string) you can double click on that line.  Depending on how you set
  4176. up your ARexx commands you will either directly execute an appropriate
  4177. ARexx script or the "Edit and save message line to clipboard; set ARexx
  4178. variable" window as shown below:
  4179.  
  4180.  
  4181. |=========================================================================|
  4182. |o| Edit and save message line to clipboard; set ARexx variable           |
  4183. |-------------------------------------------------------------------------|
  4184. |                                                                         |
  4185. | [http://www,calweb.com/~jzachar/                                      ] |
  4186. |                                                                         |
  4187. | [ SAVE CLIP ]              [CHANGE CLIP UNIT]              [  CANCEL  ] |
  4188. |_________________________________________________________________________|
  4189.  
  4190.  
  4191. will appear at the top of the screen.  Rather than the entire line, just
  4192. the email address or the web address will be transferred to the string.
  4193. If the web address does not have http:// at the beginning of the string,
  4194. that will be added.  The example above shows the AEMail web address which
  4195. is included as part of the signature block of messages I send.
  4196.  
  4197. If you hold down the shift key when you double click on such an address,
  4198. the entire line will be transferred (just as is normally done with other
  4199. message lines) and not just the email or web address.
  4200.  
  4201. The "Edit and save message line to clipboard; set ARexx variable" window
  4202. has one menu associated with it: the ARexx/DOS menu that is the same as
  4203. that used in the main menu strip.  Holding down the right mouse button
  4204. when this window is activated will bring up that menu.
  4205.  
  4206. If you have transferred an email or web address you can hit a function key
  4207. or use the right (Menu) mouse button to call the AREXX/DOS command menu to
  4208. execute an ARexx script.  The email address or web address will be
  4209. transferred to a special variable and the script will be executed.  If the
  4210. script contains the ARexx command GETVAR it will receive the variable
  4211. string in the RESULT variable and can act on it.
  4212.  
  4213. Two event exits have also been provided which avoid bringing up the
  4214. clipboard window.  If these exits are activated, the ARexx script assigned
  4215. to the exit will be immediately executed when you double click on the web
  4216. address or the email address.  Assigning the ARexx scripts to the event
  4217. exits is done in the same manner as assigning ARexx scripts to function
  4218. keys and to menu items (see the ARexx Page of the Configuration Setup
  4219. Window.)
  4220.  
  4221. You can force the clipboard window to appear by pressing the CTRL key when
  4222. you double click on the web or email address.  This is desireable if you
  4223. want alternative actions to take place when double clicking on an address.
  4224. You can then select the appropriate action with the function key or the
  4225. ARexx/DOS menu.
  4226.  
  4227. Several sample ARexx scripts have been placed in your ARexx directory
  4228. which can extract the address from the special variable and call your web
  4229. browser to go to that web page (html.aem), send a message to the email
  4230. address (sendmsg.aem) or place the email address in the address book
  4231. either as an individual address (placeaddr.aem) or as a group address
  4232. (placegrp.aem), and to delete an address from a group (deladrgrp.aem).
  4233.  
  4234. Before using this feature, you will have to assign the scripts to a
  4235. function key (your choice) or an event exit using the ARexx Page of the
  4236. Configuration Setup Window.  You should also give each of the scripts a
  4237. "Menu Title" so that it will show up in your "ARexx/DOS" menu.  If you did
  4238. not assign an event exit, function key or "Menu Title", you can always find
  4239. the script using the "Send ARexx/DOS Command..." menu item in the
  4240. "ARexx/DOS" menu.
  4241.  
  4242. Keep in mind, however, if you are an un-registered user, the function key
  4243. and menu information will not be saved between calls to AEMail.  If you
  4244. quit AEMail, this information (function key or menu) will not be available
  4245. when you next load AEMail.
  4246.  
  4247. When the function key is activated or a menu item selected, the clip
  4248. window will disappear whether or not a script is attached to that function
  4249. key.
  4250.  
  4251. If you have transferred a line to the clip window that is not a email or
  4252. web address or have edited the clip line, the function key will not work
  4253. unless you press return first.  That is because the string gadget is
  4254. activated in those situations.  With the email or web address the string
  4255. gadget is not activated.  You can tell if the string gadget is activated
  4256. or not by the presence of a cursor in the string.
  4257.  
  4258.  
  4259.                       Filtering Messages with AEMail
  4260.                       ------------------------------
  4261.  
  4262. What is message filtering?  Message filtering is the ability to direct
  4263. incoming messages to specific folders or to automatically exclude certain
  4264. messages from being stored in the system.
  4265.  
  4266. AEMail has a very powerful message filtering system.  It can direct (or
  4267. exclude) messages based upon information in the To:, From:, Reply-To:,
  4268. Subject:, cc:, bcc:, or Date: headers and (for registered users only) any
  4269. other header or text in the body of the message.  It can also use the fact
  4270. that a message is a reply, has attachments, or is forwarded as filtering
  4271. criteria.  Information in the header or body text that is checked can be a
  4272. word or phrase and wild cards can be used.  Information can also be case
  4273. sensitive or insensitive as the user desires.
  4274.  
  4275. AND and OR relationships can also be made with information coming from
  4276. different headers.
  4277.  
  4278. Filtering criteria is defined in the folder description which can be be
  4279. modified or created by using either the "Edit" or "New" sub-topic under
  4280. the "Folders menu".  See the description of the "Filter Selection Window"
  4281. under Section VIII. AEMAIL WINDOWS in this documentation for a complete
  4282. description on how to set up the filtering criteria.
  4283.  
  4284. Setting up the appropriate filtering criteria for any folder designed to
  4285. receive incoming messages with cause incoming messages (either from your
  4286. POP server or from files) to be stored in that folder rather than the
  4287. INBOX.
  4288.  
  4289. Setting up filtering criteria for the INBOX will automatically exclude any
  4290. message meeting that criteria from being stored in the INBOX.  In other
  4291. words, filtering criteria in the INBOX is used to prevent certain messages
  4292. from being stored on your system.
  4293.  
  4294. Filtering criteria can not be set up for folders designed for messages
  4295. sent out of your system.  Only messages as they are being received are
  4296. checked.  Filtering is done "on the fly" as a message enters the system.
  4297.  
  4298.                         VI. COMMAND ICON TOOL BAR
  4299.  
  4300. The Command Icon Tool Bar provides icons for accessing the major functions
  4301. of AEMail.  Each icon is described below.  Besides clicking on an icon to
  4302. activate that function, you can also use certain "hot keys" to perform
  4303. that function.  These are described with each icon description.
  4304.  
  4305. Many of the functions activated by the icon tool bar can also be activated
  4306. by menu items that are described later in this document.
  4307.  
  4308.  
  4309.                            Display Folder List
  4310.                            -------------------
  4311.  
  4312. Activation key code: "f"
  4313.  
  4314. This icon looks like a file cabinet.  Clicking on the icon will cause the
  4315. folder list to be displayed in the lower window.  This list shows each
  4316. folder with its short name (INBOX, PENDING, etc), a description of the
  4317. folder, the number of unread mesages in the folder, and the total number
  4318. of messages in the folder.
  4319.  
  4320. Unlike the count displayed in the folder icon, the total number of
  4321. messages includes any messages marked for deletion.
  4322.  
  4323.  
  4324.                            Display Address Book
  4325.                            --------------------
  4326.  
  4327. Activation key code: "a"
  4328.  
  4329. This icon looks like a closed book with the letter A on its cover.
  4330. Clicking on this icon will display the Address Book window.
  4331.  
  4332. Each address book entry contains three fields:  Nickname, Real Name, and
  4333. UserID (Address).  In addition, entries can be provided for groups with a
  4334. distribution list.  The group is identified with the heading "DISTRIBUTION
  4335. LIST" along with the number of items in the list in the top most UserID
  4336. field.  The UserID's for the members of that list are shown below that
  4337. heading.
  4338.  
  4339. For items in the distribution list, real UserID's or Nicknames can be
  4340. used.  An item in the distribution list can also be another distribution
  4341. list (In this case, only a Nickname can be used).  All nicknames are
  4342. expanded to Real Name and UserID when mail is sent.
  4343.  
  4344. A checkbox item, called "Expand" to the right of the Address Book headings
  4345. allows the user to either expand and show all members of the group or
  4346. shrink the address book so that only the group header is displayed.  This
  4347. item is normally checked indicating the groups are in expanded mode.  If
  4348. the check mark is removed, the group entries will shrink showing only the
  4349. group headings.  This feature is only available to registered users.
  4350.  
  4351. Currently, address book entries are sorted by Nickname and group entries
  4352. are interspersed with single entries.  Also Real Names are presented as
  4353. first name followed by last name rather than last name, first name.
  4354.  
  4355. If you are displaying a message, or have a message selected, when you
  4356. click on the Address Book icon, the "Reply-To:" address, if present, will
  4357. be transferred to the UserID address in the Address Book.  If the
  4358. Reply-To:  address is not present, the From:  address will be used.  If a
  4359. Real Name is present in the address it also will be transferred.  You can
  4360. force the From:  address to be transferred by holding down the shift key
  4361. when you click on the Address Book icon.  This process facilitates
  4362. transferring names and UserIDs to the Address Book.  Please keep in mind
  4363. that Reply-To: addresses normally do not have real names associated with
  4364. them, but From: addresses many times do.  If you want the real name you
  4365. may have to hold down the shift key when you click on the Address Book
  4366. icon.
  4367.  
  4368. The first time AEMail is loaded, a special Address Book entry with a
  4369. nickname of "AEMAIL" is created.  This entry can be used to send bug
  4370. reports and messages about AEMail to my email address.
  4371.  
  4372. Address book data is stored in a file in your AEMail directory called
  4373. ".addrbook".
  4374.  
  4375. A more complete description of the Address Book window is given later
  4376. under Section VIII.  AEMAIL WINDOWS, Address Book Window.
  4377.  
  4378.  
  4379.                             Retrieve Messages
  4380.                             -----------------
  4381.  
  4382. Activation key code: Right Amiga m
  4383.  
  4384. This icon looks like an envelope with an arrow coming in.  When selected,
  4385. AEMail will attempt to connect to the POP host server and transfer any
  4386. mail at the server to your Amiga.
  4387.  
  4388. If you are in offline mode (you are not connected to your Internet Service
  4389. Provider or AEMail can not connect, for some reason, to your POP server),
  4390. you will see a requester that asks:
  4391.  
  4392.  
  4393.                    !! We are running in Offline mode !!
  4394.  
  4395.                Do you wish to receive messages from files?
  4396.  
  4397.  
  4398. Clicking on [NO] will terminate the retrieval process.
  4399.  
  4400. Clicking on [YES] will bring up a file requester which will allow you to
  4401. select one or more files.  The directory for these files is setup as the
  4402. "Retrieve Mail Directory" in the "Paths Page" of the Configuration Setup
  4403. Window.  The default "Retrieve Mail Directory" is your program directory.
  4404.  
  4405. AEMail automatically recognizes mail stored as individual messages or as
  4406. message streams (such as stored by AmiPOP).  The only requirement is that
  4407. the message stream must separate messages with data beginning:
  4408.  
  4409.     ...<LF><LF>From [UserID]
  4410.  
  4411. The first message in the stream must begin with the separator without the
  4412. leading <LF>.  This is saved and checked against each line in the mail
  4413. stream (with leading <LF>) to determine where the message boundary
  4414. occurs.  This allows @{b}UserID@{ub}s other that the user's UserID in separators.
  4415.  
  4416. This also works with message streams saved by the "Save Message to File"
  4417. or the "Export.." item in the messages menu.
  4418.  
  4419. It is also assumed that lines have been stored in the file ending in <LF>
  4420. and not <CR><LF> (<CR> is $0D and <LF> is $0A).
  4421.  
  4422. If you encounter a message stream that does not use the above to separate
  4423. messages, please report what was used and what product was used to create
  4424. the message stream.  A copy of the message stream on floppy or sent to me
  4425. as an email attachment would be very handy.
  4426.  
  4427. If you are connected to your Internet Service Provider and connection can
  4428. be made to your POP mail server, all messages stored on the server will be
  4429. transferred to the Amiga.  They will be stored as individual messages in
  4430. the AEMAIL: directory with cryptic file names.
  4431.  
  4432. A progress window will also be displayed which will show the number of the
  4433. current message being received, the total number of messages being
  4434. received, the percentage of the current message already received and the
  4435. total bytes in the message being received.  The percentage will be shown
  4436. as both a number and a graphic slider.
  4437.  
  4438. This progress window also has an [ABORT] button which allows you to
  4439. terminate the receipt of the current and all remaining messages from your
  4440. POP Server.
  4441.  
  4442. PLEASE NOTE:  The abort process only aborts the receipt of messages into
  4443. the AMIGA, It does NOT abort the transfer of data from the POP Server.
  4444. While AEMail disconnects from the server, the server may be unaware of
  4445. this and continue to send the remainder of the message.  If AEMail
  4446. attempts to re-establish contact with the Server while it is still sending
  4447. the message AEMail may start to receive the middle of the previously
  4448. requested message.  AEMail has been programmed to recognize this and will
  4449. temporarily report that the POP connection could not be established.  Once
  4450. the POP Server finishes transferring the message, it should become
  4451. available for another connection.
  4452.  
  4453. The progress window will be shown both when retrieving messages from your
  4454. POP server and from files, however, if you are retrieving a message
  4455. stream, AEMail will not be able to correctly determine the number of
  4456. messages being retrieved.  Therefor the "n of n" indicator will be
  4457. incorrect.
  4458.  
  4459. If mail on the server is to be deleted, the "Delete Host Mail" item in the
  4460. Retrieve Messages menu must be checked.  If this menu item is not checked,
  4461. mail will NOT be deleted on your POP server.  This has no effect when you
  4462. are retrieving messages from a file.  NOTE:  the AEMail Installation
  4463. script automatically defaults to deleting host mail.  You will have to
  4464. un-check this item if you want to keep mail on your POP Server.
  4465.  
  4466. Since old mail may not be deleted on your server, a menu item has been
  4467. provided under the Retrieve Messages menu called "Excl Dup Msgs".  When
  4468. this item is checked duplicate messages from the mail server which are
  4469. currently stored in any incoming folder will not be stored again.  The
  4470. only folders not checked for duplicate messages are the PENDING, QUEUED
  4471. and any folder designed to hold SENT messages.  Again, the default action
  4472. with the installation script is to delete duplicate messages.
  4473.  
  4474. Currently, like sending messages to your Internet provider, the retrieval
  4475. process is run in the same execution mode as AEMail.  This means that all
  4476. of the messages must be received from the POP host before any other AEMail
  4477. process can take place.  Again, a future version will move the retrieval
  4478. process to a background process so you can proceed with other AEMail
  4479. functions while retrieval takes place.
  4480.  
  4481. You can be running another program on your Amiga, however, when the message
  4482. retrieval takes place.  If you are in iconify mode when retrieval takes
  4483. place it will be done totally in the background although you will see the
  4484. "You have mail" requester (see below).
  4485.  
  4486. Every time a new message is retrieved AND stored, the total and new
  4487. message counts in the folder list AND the folder icon strip will be
  4488. updated.  Also the top title bar will display the following message:
  4489.  
  4490.   Message n of n retrieved[/deleted] from [POP server/file], [not] saved
  4491.  
  4492. The first n indicates the current message number and the second n
  4493. indicates the total number of messages being retrieved.  (NOTE:  This
  4494. message will also appear when local mail files are being transferred, but
  4495. the counts may not be accurate if you are retrieving from a message
  4496. stream.  Also, the retrieval process from local files is so fast, you may
  4497. only see the message for the last retrieval.)
  4498.  
  4499. The [/deleted] will appear if the message has been deleted on the POP
  4500. server and [not] will appear if the message was a duplicate and was not
  4501. saved.
  4502.  
  4503. You can check for messages on your POP server and retrieve these messages
  4504. manually any time you wish by clicking on the RETRIEVE MESSAGES icon.
  4505. Also, the user has the option of retrieving messages automatically when
  4506. AEMail is first activated (provided you are connected to your Internet
  4507. provider), each time you execute your "startnet" script from within
  4508. AEMail, and when you quit AEMail.
  4509.  
  4510. You can also set a time interval in minutes in which AEMail will
  4511. periodically check for new mail (see the TCP/IP parameters page on the
  4512. Configuration Setup Window.  This function is done in the background and
  4513. if one or more messages are on your POP server, the following requester
  4514. will pop up:
  4515.  
  4516.  
  4517.                              YOU HAVE MAIL!!
  4518.  
  4519.                   n Messages available on the POP Server
  4520.  
  4521.                 Do you wish to receive these messages now?
  4522.  
  4523.  
  4524. Replying [YES] to the above requester will start the retrieval of the
  4525. messages.  This requester will only pop up when you are in the main AEMail
  4526. screen and are not in the middle of some function such as composing a
  4527. message, transferring or saving a message, printing a message, or
  4528. performing configuration changes.
  4529.  
  4530. NOTE:  if you did not specify that you wanted messages deleted from your
  4531. POP server as you transferred them to your Amiga, the "YOU HAVE MAIL"
  4532. requester will pop up each time the system checks for mail.
  4533.  
  4534.                          Display Previous Message
  4535.                          ------------------------
  4536.  
  4537. Activation key code: Cursor Left
  4538.  
  4539. This icon is a long yellow backward arrow.  When you are displaying a
  4540. message, clicking on this icon will display the previous message in the
  4541. message list.  If you are at the first message in the list, a requester
  4542. will be displayed informing you of this.
  4543.  
  4544. A more complete description of the message display window is given under
  4545. Section VIII. AEMAIL WINDOWS, Message Display Window.
  4546.  
  4547.  
  4548.                   Display Previous Folder's Message List
  4549.                   --------------------------------------
  4550.  
  4551. Activation key code: Shift Cursor Left
  4552.  
  4553. This icon is a short backward arrow.  Clicking on this icon will display
  4554. the previous folder's message list.
  4555.  
  4556. A description of the message list is given under Section VIII AEMAIL
  4557. WINDOWS, Message List Window.
  4558.  
  4559.                   Display Current Folder's Message List
  4560.                   -------------------------------------
  4561.  
  4562. Activation key code: "="
  4563.  
  4564. This icon looks like a folder.  Clicking on this icon will display the
  4565. current folder's message list.  This is one way to get back to the current
  4566. message list when you are displaying a message and the folder list is
  4567. obstructed.
  4568.  
  4569. A description of the message list is given under Section VIII AEMAIL
  4570. WINDOWS, Message List Window.
  4571.  
  4572.                     Display Next Folder's Message List
  4573.                     ----------------------------------
  4574.  
  4575. Activation key code: Shift Cursor Right
  4576.  
  4577. This icon is a short forward arrow.  Clicking on this icon will display
  4578. the next folder's message list.
  4579.  
  4580. A description of the message list is given under Section VIII AEMAIL
  4581. WINDOWS, Message List Window.
  4582.  
  4583.                            Display Next Message
  4584.                            --------------------
  4585.  
  4586. Activation key code: Cursor Right
  4587.  
  4588. This icon is a long yellow forward arrow.  When you are displaying a
  4589. message, clicking on this icon will display the next message in the
  4590. message list.  If you are at the last message in the list, a requester
  4591. will be displayed informing you of this.
  4592.  
  4593.  
  4594. A more complete description of the message display window is given under
  4595. Section VIII AEMAIL WINDOWS, Message Display Window.
  4596.  
  4597.  
  4598.                             Compose A Message
  4599.                             -----------------
  4600.  
  4601. Activation key codes: Right Amiga n (Compose a new message)
  4602.                       Right Amiga r (Reply to current message)
  4603.                       Right Amiga > (Forward current message)
  4604.                       Right Amiga e (Edit Current Message)
  4605.  
  4606. This icon looks like a sheet of paper with a pen on it.  The Compose a
  4607. Message function brings up the Compose Message window which is described
  4608. under Section VIII AEMAIL WINDOWS, Compose Message Window.  In this window
  4609. you will enter information about the message you are about to compose.
  4610. The information you enter includes the Nickname or UserID of the
  4611. receipient of the message, the subject and whether or not you want to send
  4612. cc's to anyone.
  4613.  
  4614. A special [Call Address Book] button is provided that allows you to call
  4615. up an abreviated version of the Address Book.  By clicking on an address
  4616. book name you can transfer the nickname for that address to any of the
  4617. To:, cc:, or bcc:  fields.  You select the field you want to transfer the
  4618. nickname to by a special cycle gadget in the address book display.
  4619.  
  4620. When the Address Book is displayed from the Compose window, all groups
  4621. will show as the group header and number of entries in that group.  For
  4622. AEMail registered users, an [Expand] checkmarked gadget will allow you to
  4623. expand the groups so you can see all of the entries.  Exiting from the
  4624. Address Book display is accomplished by double clicking on an address (it
  4625. will be transferred to the appropriate field and then the Address Book
  4626. will be closed) or by clicking on the Close gadget in the window border or
  4627. at the bottom of the window.
  4628.  
  4629. To compose the message text you would click on the [Compose/Edit Message]
  4630. which will call up your editor.  When you save and exit from the editor,
  4631. you will be brought back to the Compose Message window.
  4632.  
  4633. You can specify the format that you want you text to be sent as.  You can
  4634. select between 8-bit, 7-bit, quoted-printable, or encoded binary (BASE64).
  4635. This facilitates sending messages with foriegn character sets through
  4636. gateways that only handle 7 bit data.  The default is 8 bit.  Both
  4637. "quoted-printable" and "encoded binary" are 7 bit schemes for representing
  4638. 8 bit data.  When you display a message which is in either
  4639. "quoted-printable" or "encoded binary", it will be displayed correctly.
  4640.  
  4641. You can also specify any attachments you want to send with the message
  4642. through the Add Attachment Requester or you can specify a signature file
  4643. or additional headers.
  4644.  
  4645. After supplying the required information, you can then save your message
  4646. into either the PENDING or QUEUED folder or send it directly.  If you
  4647. select [Send Message Now] you MUST be connected to your Internet provider.
  4648.  
  4649. If a message has been selected in any folder, except the PENDING, QUEUED,
  4650. or SENT folders, before clicking on the COMPOSE MESSAGE icon, the compose
  4651. will be treated as a reply to the selected message.  The original Reply-To
  4652. address for the message you are replying to will appear in the To:  field
  4653. on the Compose window.  If the Reply-To:  address is not present the From:
  4654. field will be used as recipient of the reply.  You can force the From:
  4655. field to be used by holding down the shift key when you click on the
  4656. Compose icon.
  4657.  
  4658. If you are not interested in creating a reply, you can change to creating
  4659. a new message to be sent to the same (or different) recipient, or you can
  4660. forward the message to a different recipient.
  4661.  
  4662. If the message selected was in the PENDING or QUEUED folder, you will be
  4663. allowed to either edit the selected message or create a new message.  If
  4664. you edit the message it will be stored back into the the folder you
  4665. selected or will be sent (if you click on [Send Message Now].  The old
  4666. message will be automatically removed from the system.
  4667.  
  4668. If the message selected was in the SENT folder you will only be able to
  4669. create a new message.
  4670.  
  4671.                      Queue Message For Later Delivery
  4672.                      --------------------------------
  4673.  
  4674. Activation key code: "q"
  4675.  
  4676. This icon looks like a mailbox.  This function is provided to allow the
  4677. user to mark messages that you want sent later.  Normally, NO MORE EDITING
  4678. OF THESE MESSAGES should occur once they are moved to the QUEUED folder.
  4679. However, AEMail does allow this to occur.  Messages can be moved back to
  4680. the PENDING folder with the "Transfer..." item in the Messages menu.
  4681. Messages for queuing must come from the PENDING folder.  The messages can
  4682. also be placed in either the PENDING or QUEUED folders (or sent) by the
  4683. Compose Message window.
  4684.  
  4685. You can send these messages manually from the QUEUED folder any time you
  4686. want by either sending the entire folder or individual messages in the
  4687. folder.  This is done by selecting the QUEUED folder and clicking on the
  4688. SEND IMMEDIATE icon (see above) or by selecting the "Send Queued Mail"
  4689. item under the PROJECT menu.  Alternately you can press the "q" key.
  4690.  
  4691. AEMail also allows the user the option of sending queued messages
  4692. automatically when AEMail is first activated, or when the program
  4693. terminates provided you are connected to your Internet provider (see
  4694. Section V.  STARTING AEMAIL, above).  It will also perform this check when
  4695. you make connection to your Internet provider through the StartNet script
  4696. unless you have disabled this feature with the TCP/IP Parameters page of
  4697. your Configuration Setup Window.
  4698.  
  4699. With this option you can compose messages when you are in an off-line
  4700. mode, save them in PENDING while you are working on them, and then QUEUE
  4701. them when you are satisfied with the message you want to send.  The Queued
  4702. messages are then automatically sent when you log onto your Internet
  4703. Provider by the StartNet command.
  4704.  
  4705. If no messages have been selected (or if all of the messages have been
  4706. selected),  the entire PENDING folder will be queued.  Deleted messages in
  4707. the PENDING folder are never queued.
  4708.  
  4709. If there are no undeleted messages in the PENDING folder a notification
  4710. requester will appear that indicates that "No messages available to
  4711. queue".
  4712.  
  4713. The messages that are selected will be placed in the QUEUED folder and
  4714. removed from the PENDING folder.
  4715.  
  4716.                          Send Message Immediately
  4717.                          ------------------------
  4718.  
  4719. Activation key code: "s"
  4720.  
  4721. This icon looks like an envelope with an arrow going out.  An attempt will
  4722. be made to send the Selected Message(s) to their recipients.  The messages
  4723. to be sent must be in either in the PENDING or QUEUED folder.  The
  4724. messages will be sent from the PENDING folder only if the PENDING folder
  4725. is selected; otherwise they will be sent from the QUEUED folder.
  4726.  
  4727. If messages are selected, a requester will appear that asks:
  4728.  
  4729.     Do you wish to send the entire [pending/queued] folder
  4730.     or just selected messages?
  4731.  
  4732. The choices available are:
  4733.  
  4734.         [ENTIRE FOLDER]     [SELECTED MESSAGES]     [CANCEL SEND]
  4735.  
  4736. If no messages have been selected or all of the messages in the folder are
  4737. selected, the entire selected folder will be sent without a requester
  4738. appearing.  Deleted messages are never sent.
  4739.  
  4740. If there are no undeleted messages in the selected folder a notification
  4741. requester will appear that indicates that "No messages available to send".
  4742.  
  4743. A check will then be made to see if you have an active connection to your
  4744. Internet provider.  If you do not, a requester will be displayed which
  4745. informs the user that we are in offline mode and that the messages can not
  4746. be sent.
  4747.  
  4748. If you are connected to your Internet Provider, a message will appear in
  4749. the top title bar that says "Connecting to SMTP Host to send mail".  Once
  4750. the SMTP connection is made.  AEMail will display "Starting to send n
  4751. messages" where n is the number of messages selected to send.  If we are
  4752. unable to connect or an error is reported back from your Internet
  4753. provider, a message will appear in the title bar showing the nature of the
  4754. error and the messages will not be sent.
  4755.  
  4756. Sometimes, if the error message is from your Internet Provider, you will
  4757. not be able to see all of it.  If your TCPLOG is active, you will be able
  4758. to see it on the Log File, however.
  4759.  
  4760. A progress window will also be displayed which will show the current
  4761. number of the message being sent, the total number of messages being sent,
  4762. the percentage of the current message already sent and the total bytes in
  4763. the current message being sent.  The percentage will be shown as both a
  4764. number and a graphic slider.
  4765.  
  4766. If there is more than one recipient for the message, the progress
  4767. indicator will also show "Sending to n of n recipients of message" as each
  4768. recipient of the message is contacted.  This way you will see the progress
  4769. of contacting recipients for large groups of recipients.
  4770.  
  4771. This progress window also has an [ABORT] button which allows you to
  4772. terminate the sending of the current and all remaining messages to your
  4773. SMTP Server.
  4774.  
  4775. All nicknames used in To:, cc:, and bcc:  header fields will be expanded
  4776. to the form:  Real Name<userid>.  Group nicknames will be expanded to the
  4777. Real Names and userids of all members of the group, or, if "Send Header
  4778. Only" is set for that group, only the group header will be displayed in
  4779. the To:  field.
  4780.  
  4781. When each message is successfully sent, the following message will be
  4782. displayed in the upper title bar:
  4783.  
  4784.     Mail n of n successfully sent to [To: addressee]
  4785.  
  4786. The n in the above message indicates the message number and the total
  4787. messages to be sent.  The [To:  addressee] indicates who the message was
  4788. addressed to.  If it was addressed to multiple addressees, the first
  4789. addressee will appear followed by ", et al...".
  4790.  
  4791. The message will also be placed in the SENT folder and marked as deleted
  4792. in the PENDING or QUEUED folder.
  4793.  
  4794. In the current version of AEMail, the send process operates in the same
  4795. execution mode as AEMail.  This means that you can not perform any other
  4796. AEMail operation until the message is either rejected by your Internet
  4797. provider or successfully received by your provider (unless you abort the
  4798. process).  In a future version, this process will be moved to a background
  4799. process so that you can perform work in AEMail while the sending of the
  4800. message proceeds.
  4801.  
  4802.  
  4803.                       Export (Save) Message To File
  4804.                       -----------------------------
  4805.  
  4806. Activation key code: Right Amiga v
  4807.  
  4808. This icon looks like a diskette.  A message must be selected before
  4809. activating this function and multiple messages can be selected.  A message
  4810. that is currently being displayed is considered a selected message.
  4811.  
  4812. You can save multiple messages as a block of messages or as individual
  4813. messages.  If you have selected multiple messages a requester will be
  4814. displayed as follows:
  4815.  
  4816.                    More than one message marked to save
  4817.  
  4818.                    Do you want to save them as a group
  4819.                              or Individually
  4820.  
  4821.                         If you select Individually
  4822.                        a File Requester will appear
  4823.                              for each message
  4824.  
  4825.                 [Save as Group]        [Save Individually]
  4826.  
  4827.  
  4828. Unless you are saving the messages as a group, a requester will also be
  4829. displayed for each message which will describe the message as to Date,
  4830. From, To, and Subject and ask you if you want to perform the requested
  4831. action.  Selecting [SAVE] will display a file requester in which you will
  4832. be asked to enter the file name you want the message saved as, and
  4833. selecting [CANCEL] will not save the current message.
  4834.  
  4835. If you are saving the message as a group, only the file requester will
  4836. appear.
  4837.  
  4838. The complete message, including all attachments, is saved in the format in
  4839. which the message was received from the POP server except that
  4840. CARRAGE-RETURN/LINEFEED sequences are stored as LINEFEEDs alone.  Also,
  4841. the message ending sequence (.<CR><LF>) is eliminated and any embedded
  4842. ..<CR><LF> are changed to .<LF> as they would normally appear in a
  4843. message.
  4844.  
  4845. If the messages are saved as a group, each message will have a special
  4846. header separating it from the following message.  This header consists of
  4847. a line feed followed by:
  4848.  
  4849.     From [your UserID]@[Your POP Server name] [date]
  4850.  
  4851. Only the special header (not the line feed) will appear for the first
  4852. message.
  4853.  
  4854.  
  4855. This facilitates importing a group of messages back into AEMail. (See
  4856. the Retrieve Messages command and the menu item From Local File...  under
  4857. the Retrieve Msgs menu.)
  4858.  
  4859. If you want to save the body of the message or an attachment in its
  4860. converted format, you can do that with either the [SAVE TEXT] gadget in
  4861. the message display window or with the Attachment Requester that can be
  4862. brought up when you display a message with attachments (see Attachment
  4863. Requester under VIII.  AEMAIL WINDOWS below).
  4864.  
  4865.  
  4866.                                   Print
  4867.                                   -----
  4868.  
  4869. Activation key code: Right Amiga p
  4870.  
  4871. This icon looks like a printer.  You must select the messages you want
  4872. printed prior to selecting this icon.  Multiple message selection works
  4873. with this command.  If no messages have been selected, you will be asked
  4874. if you want to print a list of the messages in that folder.  Also, if this
  4875. icon is selected while you are in the Address Book, the address book
  4876. contents will be printed.
  4877.  
  4878. When first activated, the print function will bring up a requester asking
  4879. how many copies you wish to print.  It will be preset to 1.  You can
  4880. change this number to the number of copies you wish to print.  The [+] and
  4881. [-] gadgets to the right of the numeric entry gadget allow you to
  4882. increment or decrement the number.  Pressing RETURN or selecting the [OK]
  4883. gadget will then start the printing process.
  4884.  
  4885. Each of the messages will be printed in the order that they appear in your
  4886. message list.  All selected messages will be printed whether they are
  4887. marked for deletion or not.
  4888.  
  4889. A progress indicator will appear as each message is being sent to your
  4890. printer which shows the percent being printed and the total bytes being
  4891. printed.  This progress indicator has an [ABORT] button which allows you
  4892. to terminate the printing.  However, beware, most printers have a
  4893. substantial buffer which will probably receive all of your messages quite
  4894. quickly.  Once the messages are in the printer's buffer, the printing can
  4895. not be cancelled without turning your printer off.
  4896.  
  4897. A heading line will be printed on each page of the listing which contains
  4898. the following information:
  4899.  
  4900. Message Sent on MM/DD/YY (DOW) at HH:MM [AM/PM], [from/to] [name]  Page n
  4901.  
  4902. where
  4903.  
  4904.     MM/DD/YY is the date the message was sent (received) or composed,
  4905.     DOW is the day of the week the message was sent (received) or
  4906.         composed,
  4907.     HH:MM is the hour and minute the message was sent (received) or
  4908.         composed using a 12 hour clock,
  4909.     [AM/PM] is either AM or PM.
  4910.     [from/to] if the message was received you will see "from", and if you
  4911.         composed or sent the message you will see "to",
  4912.     [name] the full name of the sender or nickname of recipient,
  4913.     n is the the page number.
  4914.  
  4915. On the first page only, if there are attachments, the following line will
  4916. appear below the heading line:
  4917.  
  4918. This message has attachments (See last page for list).
  4919.  
  4920. On a separate page after the message, the attachment list will appear,
  4921. providing the "Include Attachment List in Print Out" item is checkmarked
  4922. in the General Parameters portion of the Configuration Setup Window.
  4923. Printing the attachment list is the default action.
  4924.  
  4925. If attachments are a Text or Message type and are either 7-bit, 8-bit, or
  4926. quoted-printable encoding format they will be printed following the body
  4927. of the message.  Other types of attachments you will have to save to a
  4928. file and print the file with an appropriate printing program.
  4929.  
  4930. Note:  no check is made whether a selected message is deleted or not.  If
  4931. a deleted message is selected it will be printed anyway (this is probably
  4932. desireable in certain circumstances).  If you don't want to print it,
  4933. de-select it!
  4934.  
  4935. This function can also print a list of all messages in a folder.  To do
  4936. this, DO NOT select any messages in the folder.  A requester will appear
  4937. when you select either the printer command icon or the Print menu item
  4938. which says:
  4939.  
  4940.  
  4941.                       No messages selected to print!
  4942.  
  4943.                        Do you want to print a list
  4944.                         of all the messages in the
  4945.                          [name of folder] folder?
  4946.  
  4947.                       [YES]                     [NO]
  4948.  
  4949. By selecting [YES] you will print a list of the messages.  Messages will
  4950. be printed in the order that they appear in the message list.
  4951.  
  4952. Selecting [NO] will terminate the printing function.
  4953.  
  4954. Printing uses your Preferences Printer.  You should set it up properly
  4955. before executing AEMail, but you can set it up while in AEMail by using
  4956. the General Parameters page on the Configuration Setup Window.  You can
  4957. also specify a print file that the output will be directed to.
  4958.  
  4959. As a default AEMail will space 4 lines down before starting to print.
  4960. This "Top Margin", however, can be changed in the General Parameters page
  4961. of the Configuration Setup Window.
  4962.  
  4963.  
  4964.                          Delete/Undelete Messages
  4965.                          ------------------------
  4966.  
  4967. Activation key code: "x"
  4968.                      Right Amiga x
  4969.  
  4970. This icon looks like a garbage can.  This will delete OR undelete all
  4971. messages that have been selected in a message list.  Whether deleting or
  4972. undeleting takes place depends on the current status of the message.  If
  4973. it is currently marked for deletion, it will be undeleted.
  4974.  
  4975. This function only marks (or unmarks) messages for deletion.  The messages
  4976. will actually be deleted only when AEMail exits.  The message counts in
  4977. the folder icons, however, will only represent undeleted messages.  You
  4978. can also suppress the display of deleted messages in the message list by
  4979. unchecking the Show/Deleted Messages item under the Messages menu.
  4980.  
  4981.                   Copy Selected Messages to a new folder
  4982.                   --------------------------------------
  4983.  
  4984. Activation key code: Right Amiga =
  4985.  
  4986. This icon looks like two sheets of paper, one laying over the other.  This
  4987. will copy all selected messages from the selected folder to a new folder.
  4988. When you select this icon a Notification window appears which says:
  4989.  
  4990.  
  4991.                     Select Folder to Copy Messages To!
  4992.  
  4993.                                  [CANCEL]
  4994.  
  4995.  
  4996. When the window appears, click on the folder icon that represents the
  4997. folder you want the messages copied to.  The window will automatically
  4998. disappear at that time.
  4999.  
  5000. The selected messages will be copied to that folder.  Messages will remain
  5001. in both folders.
  5002.  
  5003. Clicking on [CANCEL] before clicking on a folder will cancel the
  5004. operation.
  5005.  
  5006. As the messages are being copied, the folder message list that the
  5007. messages are copied to will be displayed (unless a message is being
  5008. displayed).  Once the copy is complete, the folder message list from which
  5009. the messages are copied will be displayed unless a message is being
  5010. displayed.
  5011.  
  5012.  
  5013.                 Transfer Selected Messages to a new folder
  5014.                 ------------------------------------------
  5015.  
  5016. Activation key code: Right Amiga -
  5017.  
  5018. This icon looks like a sheet of paper with arrows pointing to the right.
  5019. It will move all selected messages from the selected folder to a new
  5020. folder.  When you select this icon a Notification window appears which
  5021. says:
  5022.  
  5023.  
  5024.                   Select Folder to Transfer Messages To!
  5025.  
  5026.                                  [CANCEL]
  5027.  
  5028.  
  5029. When the window appears, click on the folder icon that represents the
  5030. folder you want the messages transferred to.  The window will
  5031. automatically disappear at that time.
  5032.  
  5033. The selected messages will be copied to that folder, and the messages in
  5034. the folder from which the messages are copied will be marked as "deleted".
  5035.  
  5036. Clicking on [CANCEL] before clicking on a folder will cancel the
  5037. operation.
  5038.  
  5039. As the messages are being transferred, the folder message list that the
  5040. the messages are transferred to will be displayed (unless a message is
  5041. being displayed).  Once the transfer is complete, the folder message list
  5042. from which the messages are copied and deleted will be displayed unless a
  5043. message is being displayed.
  5044.  
  5045.  
  5046.                      Start TCP/IP Network Connection
  5047.                      -------------------------------
  5048.  
  5049. Activation key code: Right Amiga t
  5050.  
  5051. This icon looks like a horizontal jagged line.  This will start your
  5052. network connection to your Internet Provider using your StartNet script.
  5053. It performs the same function as the "Start Net" item under the TCP/IP
  5054. menu (see below under Section VII, AEMAIL MENUS.
  5055.  
  5056.                    Terminate TCP/IP Network Connection
  5057.                    -----------------------------------
  5058.  
  5059. Activation key code: Right Amiga h
  5060.  
  5061. This icon looks like a horizontal jagged line with a red slash through it.
  5062. This will terminate your network connection to your Internet Provider
  5063. using your StopNet script.  It performs the same function as the "Stop
  5064. Net" item under the TCP/IP menu (see below under Section VII, AEMAIL
  5065. MENUS.
  5066.  
  5067.                             VII. AEMAIL MENUS
  5068.  
  5069. Whenever you are displaying folder lists, message lists, or messages
  5070. themselves a menu strip is active and will be displayed when you press the
  5071. right mouse button.
  5072.  
  5073. Below is a list of all the current menus in the AEMail menu strip:
  5074.  
  5075.     Project menu
  5076.     Folders menu
  5077.     Messages menu
  5078.     Retrieve Messages menu
  5079.     TCP/IP menu
  5080.     ARexx/DOS menu
  5081.  
  5082. The ARexx/DOS menu is also available when the "Edit and save message line
  5083. to clipboard; set ARexx variable" window is active.
  5084.  
  5085. A description of each of the menus, menu items, and sub-items is given
  5086. below:
  5087.  
  5088.  
  5089.                                Project menu
  5090.                                ------------
  5091.  
  5092. Configuration...
  5093.  
  5094.     This has five submenu items for controlling your configuration.
  5095.     These sub-menu items are:
  5096.  
  5097.     Open...
  5098.  
  5099.         This brings up a file requester which allows you to specify
  5100.         a configuration file other than the configuration file assigned to
  5101.         the current user.  This configuration file must have the same mail
  5102.         directory as your current configuration.  Once you have opened
  5103.         this configuration file it becomes your current active
  5104.         configuration.
  5105.  
  5106.         Although you can specify an alternate configuration file with this
  5107.         menu sub-item, your original configuration file will be used if
  5108.         you quit AEMail and reload it.  To permanently change the
  5109.         configuration file name and or location you will have to re-perform
  5110.         the Installation process.
  5111.  
  5112.         The use of this menu sub-item and the "SAVE AS" sub-item allows
  5113.         you to specify alternate locations for your mail Identity items
  5114.         (i.e., POP3 Userid, Password, Pop Server, SMTP Server, etc.).
  5115.  
  5116.     Edit...
  5117.  
  5118.         The Configuration Setup Window will be activated allowing complete
  5119.         configuration data to be entered for the current active
  5120.         configuration file.  See the description of the Configuration
  5121.         Setup Window previously under the IV.  CONFIGURATION:  section in
  5122.         this document for details on the Configuration Setup Window.
  5123.  
  5124.     Save
  5125.  
  5126.         This will save the current configuration settings in the
  5127.         currently active configuration file.  It serves the same
  5128.         purpose as the previously "Save Settings" menu item (AEMail
  5129.         versions prior to 1.13) in which all of the current settings
  5130.         including the current state of the "Display Full Header",
  5131.         "Forward Body Text Only", "Include Header in Response",
  5132.         "Exclude Duplicate Messages" and "Delete Host Mail" menu
  5133.         items.
  5134.  
  5135.     Save As...
  5136.  
  5137.         This is the same as "Save" except that a file requester
  5138.         will be brought up which allow you to rename the current
  5139.         active configuration file.  This new configuration file
  5140.         will have the same mail directory as the current configuration
  5141.         file.  The new name becomes the new current active configuration
  5142.         file; however, if you quit AEMail and reload, the original
  5143.         configuration file specified in the CONFIG= Tool Type will again
  5144.         be the active configuration file.
  5145.  
  5146.         To permanently change the configuration file name and or location
  5147.         you will have to re-perform the Installation process.
  5148.  
  5149.     Restore Default
  5150.  
  5151.         This reads in the file specified in the CONFIG= Tool Type
  5152.         OR the config= parameter on the Shell call to AEMail.  The
  5153.         particular file that is used is referred to as your "base
  5154.         configuration".  The base configuration now becomes your
  5155.         currently active configuration file.
  5156.  
  5157.  
  5158. Send Queued Mail
  5159.  
  5160.     Will send all messages in the QUEUED folder.  See the
  5161.     SEND MESSAGE IMMEDIATELY command in the COMMAND ICON STRIP
  5162.     section above.  This action will also occur automatically
  5163.     when you first load and when you exit AEMail provided you
  5164.     are connected to your Internet provider.
  5165.  
  5166. Iconify AEMail
  5167.  
  5168.     You can iconify AEMail with an iconify bar on the Workbench screen
  5169.     with this menu item.  When this menu item is selected, the AEMail
  5170.     screen will be closed and a button bar will appear on the Workbench
  5171.     screen with
  5172.  
  5173.               AEMail (Click on Close or with RMB to restore)
  5174.  
  5175.     in the title.  When the iconified bar is in selected mode, clicking
  5176.     either on the close gadget or with the right mouse button will restore
  5177.     the AEMail screen.
  5178.  
  5179.     Initially the iconify bar will open at the top center of the
  5180.     Workbench screen, but it can be dragged anywhere on the screen.
  5181.     AEMail remembers where you dragged the bar so the next time
  5182.     you iconify, the bar will be at that new position.
  5183.  
  5184.     There is also a hotkey provided for iconifying AEMail.  This is
  5185.     RIGHT-AMIGA-I.  This hot key, and also LEFT-AMIGA-I, will also
  5186.     restore the AEMail screen when in the iconify mode.
  5187.  
  5188.     When in iconify mode, periodic checking of mail on your POP server
  5189.     is still done.  If mail is found, the "YOU HAVE MAIL" requester
  5190.     will pop up on the Workbench mail.  You can retrieve the mail
  5191.     immediately by clicking on the YES gadget.  The requester will
  5192.     disappear and retrieval of messages will occur in the background
  5193.     and no progress indicator will appear.  When you return to the
  5194.     AEMail screen, the new messages will be in your INBOX folder.
  5195.  
  5196.     You can also push the AEMail screen to the back exposing the
  5197.     screen immediately behind the AEMail screen or the WorkBench
  5198.     screen by hitting LEFT-AMIGA-M when the AEMail screen is being
  5199.     displayed.  This is standard Amiga action.
  5200.  
  5201.     If the AEMail screen has been pushed to the back, hitting
  5202.     LEFT-AMIGA-M will bring the screen forward.  Note:  if other
  5203.     screens, besides the Workbench screen, are also present, they
  5204.     may be moved to the front first so that you may have to hit
  5205.     LEFT-AMIGA-M several times before the AEMail screen appears.
  5206.  
  5207.     Since there is no screen to bring forward, this will not work
  5208.     if the iconify action has been taken.
  5209.  
  5210. Send Notification...
  5211.  
  5212.     This menu item will bring up the "Send AEMail Notification Request"
  5213.     window (See REGISTRATION under Section II, SYSTEM REQUIREMENTS).  The
  5214.     purpose of this menu item is to allow users to send an AEMail
  5215.     notification message after they have initially loaded the current
  5216.     version of AEMail to inform the author of any changes in your
  5217.     information such as a change of email address or any change in the
  5218.     optional information.  If you had not previously sent some of the
  5219.     optional information under the "Options" tab and care to do so now,
  5220.     you can use this menu item to so inform the author.
  5221.  
  5222. Getting Help
  5223.  
  5224.     This will bring up the AEMail.guide page that describes how to get
  5225.     help with AEMail using the [HELP] key.  There are also special help
  5226.     command that can be obtained by using qualifier keys (SHIFT, ALT) with
  5227.     the [Help] key.
  5228.  
  5229. About
  5230.  
  5231.     This will display the name, version, and date,  of the program
  5232.     followed by the ARexx Port Name and information as to whether or not
  5233.     the shareware registration message has been received and who the
  5234.     version is registered to (with serial number).
  5235.  
  5236.     Below that is information on how to contact the author of the
  5237.     program.
  5238.  
  5239.  
  5240. Quit...
  5241.  
  5242.     Exits AEMail.
  5243.  
  5244.     When this menu item is selected, AEMail first checks to see
  5245.     if you are connected to your Internet provider.  If you are, a
  5246.     connection will be made to your POP server to see if there are
  5247.     any messages available on the server.  If there are, the following
  5248.     requester will appear:
  5249.  
  5250.                   n Messages Available on the POP Server
  5251.  
  5252.                 Do you wish to receive these messages now?
  5253.  
  5254.     If you click on the [YES] button, those message will be retrieved
  5255.     at this point.  If you click on [NO], no message retrieval will take
  5256.     place.
  5257.  
  5258.     After AEMail checks to see if any messages are available on the
  5259.     POP Server, it also checks to see if any messages are in the
  5260.     QUEUED folder (messages queued to be sent).  If there are, the
  5261.     following requester will appear:
  5262.  
  5263.                   You have n messages queued to be sent
  5264.  
  5265.                  Do you wish to send these messages now?
  5266.  
  5267.     If you click on the [YES] button, all of the messages in the QUEUED
  5268.     folder will be sent immediately.  If you click on [NO], the queued
  5269.     messages will not be sent.
  5270.  
  5271.     After checking for POP messages and QUEUED messages, the following
  5272.     requester will appear:
  5273.  
  5274.             Do you wish to terminate your Host connection now?
  5275.  
  5276.     Selecting the [YES] button will cause the "stopnet" script to be
  5277.     executed terminmating your TCP/IP connection to your Internet
  5278.     provider.
  5279.  
  5280.     You can disable all of these requesters with a checkmarked item
  5281.     in the TCP/IP display on the Configuration Setup Window.  If they are
  5282.     disabled, the [NO] action will be assumed which each of the
  5283.     requesters.
  5284.  
  5285.     Finally, a requester will be displayed that asks:
  5286.  
  5287.                        Do You Really Want to Quit?
  5288.  
  5289.     Clicking on [YES] will terminate the program and [NO] will return to
  5290.     the program.
  5291.  
  5292.     When AEMail exits, all messages marked for deletion will be
  5293.     deleted and any configuration files in which data has been updated
  5294.     will be re-written.  You will probably see a great deal of disk
  5295.     activity at this time.  While this disk activity is going on, a
  5296.     window will be displayed on the Workbench screen saying:
  5297.  
  5298.  
  5299.                  Updating all AEMail Configuration Files!
  5300.  
  5301.  
  5302.     When updating is complete, this window will disappear.
  5303.     WARNING:  DO NOT turn your computer off while this window is being
  5304.     displayed.  If you do your disk will be corrupted!
  5305.  
  5306.  
  5307.                                Folders menu
  5308.                                ------------
  5309.  
  5310. New...
  5311.  
  5312.     The Configure Folder window will be activated indicating that a new
  5313.     folder should be created.  See the description of the Configure Folder
  5314.     window later in this document for details on how to create a new
  5315.     folder.
  5316.  
  5317. Edit...
  5318.  
  5319.     The Configure Folder window will be activated indicating that the
  5320.     current selected folder description should be edited.  The current
  5321.     selected folder is the folder that has a depressed frame.  You can
  5322.     change the selected folder by single clicking on the appropriate
  5323.     folder icon or selecting a folder from the folder list.  See the
  5324.     description of the Configure Folder window later in this document for
  5325.     details on how to change the folder description.
  5326.  
  5327. Delete
  5328.  
  5329.     This will delete the folder that has been selected.  You will not be
  5330.     able to delete a folder that has active messages in it.  If there are
  5331.     only deleted messages in the folder, the messages will be immediately
  5332.     deleted along with the folder.  There is no way you can get these
  5333.     deleted messages back.
  5334.  
  5335. Move...
  5336.  
  5337.     This menu item allows you to re-arrange the folder list.  Select the
  5338.     folder you want to move either from the folder list or the folder
  5339.     icon.  When you select this menu item, a Notification window appears
  5340.     which says:
  5341.  
  5342.              Select folder to place [folder-name] folder after
  5343.  
  5344.                                  [CANCEL]
  5345.  
  5346.     When the window appears, click on the folder icon (or the line in the
  5347.     folder list) that represents the folder you want to move the selected
  5348.     folder after.  The window will automatically disappear at that time
  5349.     and the folder list and icons will be re-arranged.
  5350.  
  5351.     Clicking on [CANCEL] before clicking on a folder will cancel the
  5352.     operation.
  5353.  
  5354.     You can not re-arrange the position of the INBOX.
  5355.  
  5356. Set Sort Key...
  5357.  
  5358.     Activates the Set Sort Key window for the current selected folder.
  5359.     See the description of the Set Sort Key window later in this document
  5360.     for details on how to set the folder sort keys.
  5361.  
  5362. Folder List
  5363.  
  5364.     This has three submenu items as follows:
  5365.  
  5366.     Display
  5367.  
  5368.     This will display the folder list in the lower window.  This is the
  5369.     same as clicking on the "Display Folder List" icon.  This list shows
  5370.     each folder with its short name (INBOX, PENDING, etc), a description
  5371.     of the folder, the number of unread mesages in the folder, and the
  5372.     total number of messages in the folder.
  5373.  
  5374.     Backup...
  5375.  
  5376.     This will backup your current folder.config file.  A file requester
  5377.     will be presented asking for the name of your backup file.  The
  5378.     default name will be "folder.config.bak", but you can name it anything
  5379.     but "folder.config".  This facility has been provided to create a
  5380.     backup of the folder.config file in the event it becomes corrupted.
  5381.  
  5382.     WARNING: The format of the backup folder.config file is not the same
  5383.     as that of the folder.config file.  You cannot copy the backup file
  5384.     over the folder.config file and have a valid folder.config file.  You
  5385.     must use the "Restore" menu item listed below to properly restore the
  5386.     backup file.
  5387.  
  5388.     If you mistakenly copy the backup file over the folder.config file you
  5389.     can restore a valid folder.config file by first deleting the bad
  5390.     folder.config file and then using the "Restore" command below.
  5391.  
  5392.     Restore...
  5393.  
  5394.     This will restore your current folder.config file from a previously
  5395.     saved folder.config backup file.  A file requester will be presented
  5396.     asking for the name of the backup file.  The default name will be
  5397.     "folder.config.bak".
  5398.  
  5399.     YOU MUST USE THIS COMMAND TO PROPERLY RESTORE THE BACKUP FILE.
  5400.  
  5401.     WARNING:  If you restore a backup file that has a different list of
  5402.     folders (or a different order of files), the new folder list will not
  5403.     take effect until you quit and then reload AEMail.
  5404.  
  5405.  
  5406. Remove DELETED messages
  5407.  
  5408.     This will IMMEDIATELY remove ALL messages marked for deletion in the
  5409.     current active folder.  This means that they will no longer appear in
  5410.     the message list for that folder and they will be physically deleted
  5411.     from your mail directory.
  5412.  
  5413.     Before actually removing the messages the following requester will
  5414.     appear:
  5415.  
  5416.                This will remove all deleted messages in the
  5417.                            [folder_name] folder
  5418.                 If you continue you can not retrieve them!
  5419.  
  5420.     You will given the option to either [CONTINUE] or [CANCEL].  If you
  5421.     select [CONTINUE] all the messages marked for deletion in the folder
  5422.     will be removed.  [CANCEL] will abort the operation.
  5423.  
  5424.     A busy pointer will be displayed while the messages are being removed.
  5425.  
  5426.  
  5427.  
  5428.                               Messages menu
  5429.                               -------------
  5430.  
  5431. Show
  5432.  
  5433.     This has two checkmarked submenu items for controlling your message
  5434.     list display.  These sub-menu items are:
  5435.  
  5436.     Deleted Messages
  5437.  
  5438.         If this sub-item is checked, deleted messages will be shown in the
  5439.         message list.  If it is unchecked, deleted messages will not be
  5440.         shown.  This sub-item is checked when AEMail first comes up.
  5441.  
  5442.     UnRead Msgs Only
  5443.  
  5444.         If this sub-item is checked, only unread messages will be
  5445.         displayed in the message list.  If it is unchecked all messages
  5446.         will be displayed.  This sub-item is unchecked when AEMail first
  5447.         comes up.
  5448.  
  5449. Compose...
  5450.  
  5451.     Activates the Compose Message window, described later in this
  5452.     document, to create a NEW message to be sent whether or not a message
  5453.     is currently selected.
  5454.  
  5455. Reply
  5456.  
  5457.     Activates the Compose Message window to reply to the current selected
  5458.     message.  See the description of the Compose Message window later in
  5459.     this document.
  5460.  
  5461.     There are two sub-menus which are:
  5462.  
  5463.     Use Reply-To...
  5464.  
  5465.         The Reply-To: address of the selected message will be used as the
  5466.         recipient of the reply.  If the Reply-To:  address is not present,
  5467.         the From:  address will be used.
  5468.  
  5469.     Use From...
  5470.  
  5471.         This forces the From: address to be used as the recipient of the
  5472.         reply.
  5473.  
  5474.     If a message is not selected when one of the sub-menu items is
  5475.     activated an error requester will appear.
  5476.  
  5477. Forward...
  5478.  
  5479.     Activates the Compose Message window to forward the current selected
  5480.     message.  See the description of the Compose Message window later in
  5481.     this document.
  5482.  
  5483.     If a message is not selected when this menu item is activated an error
  5484.     requester will appear.
  5485.  
  5486. Edit...
  5487.  
  5488.     Using this menu item will allow you to edit a message selected in
  5489.     either the PENDING or QUEUED folders.  It has the same effect as
  5490.     clicking on the Compose icon when you have selected a message in
  5491.     either the PENDING or QUEUED folders.
  5492.  
  5493.     If you have not selected a message in either the PENDING or QUEUED
  5494.     folder when this menu item is activated an error requester will
  5495.     appear.
  5496.  
  5497.  
  5498. Select None
  5499.  
  5500.     This menu item will de-select all messages in the selected folder.
  5501.  
  5502. Select All
  5503.  
  5504.     This menu item will select all messages in the selected folder.
  5505.     Selected messages will be marked with an asterick (*) in the first
  5506.     position of the message in the message list display.
  5507.  
  5508. Last Selected
  5509.  
  5510.     This menu item will re-select those messages that were last selected.
  5511.     If you did a multiple selection on a group of messages and then
  5512.     performed an operation on the group of messages (such as deleting,
  5513.     copying, saving the group to a file, etc.), the messages will be
  5514.     de-selected as the operation is performed on each message.  The "Last
  5515.     Selected" menu item will allow you to re-select the same previously
  5516.     selected messages so that you can perform another operation on the
  5517.     same group of messages.
  5518.  
  5519. Export...
  5520.  
  5521.     Same as the SAVE MESSAGE TO FILE command described previously in this
  5522.     document.
  5523.  
  5524. Copy...
  5525.  
  5526.     This menu copies all selected messages from the selected folder to a
  5527.     new folder.  When you select this menu a Notification window appears
  5528.     which says:
  5529.  
  5530.  
  5531.                     Select Folder to Copy Messages To!
  5532.  
  5533.                                  [CANCEL]
  5534.  
  5535.  
  5536.     When the window appears, click on the folder icon that represents the
  5537.     folder you want the messages copied to.  The window will automatically
  5538.     disappear at that time.
  5539.  
  5540.     The selected messages will be copied to that folder.  Messages will
  5541.     remain in both folders.
  5542.  
  5543.     Clicking on [CANCEL] before clicking on a folder will cancel the
  5544.     operation.
  5545.  
  5546.     As the messages are being copied, the folder message list that the
  5547.     messages are copied to will be displayed (unless a message is being
  5548.     displayed).  Once the copy is complete, the folder message list from
  5549.     which the messages are copied will be displayed unless a message is
  5550.     being displayed.
  5551.  
  5552.  
  5553. Transfer...
  5554.  
  5555.     This menu moves all selected messages from the selected folder to a
  5556.     new folder.  When you select this menu a Notification window appears
  5557.     which says:
  5558.  
  5559.  
  5560.                   Select Folder to Transfer Messages To!
  5561.  
  5562.                                  [CANCEL]
  5563.  
  5564.  
  5565.     When the window appears, click on the folder icon that represents the
  5566.     folder you want the messages transferred to.  The window will
  5567.     automatically disappear at that time.
  5568.  
  5569.     The selected messages will be copied to that folder, and the messages
  5570.     in the folder from which the messages are copied will be marked as
  5571.     "deleted".
  5572.  
  5573.     Clicking on [CANCEL] before clicking on a folder will cancel the
  5574.     operation.
  5575.  
  5576.     As the messages are being transferred, the folder message list
  5577.     that the the messages are transferred to will be displayed (unless a
  5578.     message is being displayed).  Once the transfer is complete, the
  5579.     folder message list from which the messages are copied and deleted
  5580.     will be displayed unless a message is being displayed.
  5581.  
  5582.  
  5583. Print
  5584.  
  5585.     Same as the PRINT SELECTED MESSAGES command described previously in
  5586.     this document.
  5587.  
  5588.  
  5589. Delete/Undelete...
  5590.  
  5591.     Same as the DELETE/UNDELETE MESSAGE command described previously in
  5592.     this document.
  5593.  
  5594. Lock/Unlock
  5595.  
  5596.     This menu item will prevent messages from being sent from either the
  5597.     PENDING or QUEUED folders.  A locked message is indicated by an "L" in
  5598.     the message list.  A deleted message can not be locked (although it
  5599.     also can not be sent).  This command works as a toggle.  When this
  5600.     menu item is selected, all messages marked as selected (*) but not
  5601.     marked as DELETED or LOCKED will be LOCKED.  All selected messages
  5602.     marked as LOCKED will be UNLOCKED.
  5603.  
  5604. Display Full Header
  5605.  
  5606.     This is a checkmarked menu sub-item.  When checked, all message
  5607.     headers will be displayed in the message.  Since many of these headers
  5608.     are somewhat cryptic and could be confusing and not always understood
  5609.     by the user, the normal action is display only certain header lines.
  5610.     The default action is to display the following headers:  From:,
  5611.     Reply-To:  To:, Date:, Subject:, Organization:, cc:, and bcc:, but you
  5612.     can control this default minimum header list with the General
  5613.     Parameters page of the Configuration Setup Window.
  5614.  
  5615.     This menu sub-item is very useful for debugging purpose to see all of
  5616.     the headers what any particular message carries.
  5617.  
  5618.     The current state of this checkmarked item is saved in the
  5619.     configuration file whenever the "Configuration/Save" menu item is
  5620.     selected.  It can also be set or reset by the General Parameters page
  5621.     on the Configuration Setup Window.
  5622.  
  5623. Forward Body Text Only
  5624.  
  5625.     This is a checkmarked menu sub-item.
  5626.  
  5627.     When you forward a message, the normal action is to include the
  5628.     header lines in the forwarded message.  The number of header lines is
  5629.     controlled by the "Display Full Hdr" checkedmark menu item above.
  5630.     Minimum headers will be included if that item is not checked.  If the
  5631.     message to be forwarded contains attachments, full headers will always
  5632.     be sent regardless of the state of the "Display Full Hdr" item.
  5633.  
  5634.     You can suppress all headers and forward only the body text by
  5635.     checking this checkmarked menu sub-item.  This will also forward only
  5636.     the body text for messages with attachments.  In other words, the
  5637.     attachments will not be included with the forwarded message.
  5638.  
  5639.     The current state of this checkmarked item is saved in the
  5640.     configuration file whenever the "Configuration/Save" menu item is
  5641.     selected.  It can also be set or reset by the General Parameters page
  5642.     on the Configuration Setup Window.
  5643.  
  5644. Include Header in Response
  5645.  
  5646.     This is a checkmarked menu sub-item.  When checked the minimum header
  5647.     lines will be included for the quoted message when composing a
  5648.     response.  If it is not checked, no header information will appear.
  5649.  
  5650.     The current state of this checkmarked item is saved in the
  5651.     configuration file whenever the "Configuration/Save" menu item is
  5652.     selected.  It can also be set or reset by the General Parameters page
  5653.     on the Configuration Setup Window.
  5654.  
  5655.  
  5656.  
  5657.                           Retrieve Messages menu
  5658.                           ----------------------
  5659.  
  5660. From POP Host
  5661.  
  5662.     This will only retrieve messages from the POP Server.  See the
  5663.     RETRIEVE MESSAGES command described previously in this
  5664.     document for a full explanation of the retrieval process.
  5665.  
  5666.     If your TCP/IP software is not active or connection to the
  5667.     POP Server can not be made, the RETRIEVE MESSAGES command
  5668.     will return silently with the information that the POP Server
  5669.     could not be reached in the title bar.
  5670.  
  5671. From Local File...
  5672.  
  5673.     This will only retrieve messages from a local file.  No attempt
  5674.     will be made to connect to the POP Server.  See the
  5675.     RETRIEVE MESSAGES command described previously in this
  5676.     document for a full explanation of the retrieval process.
  5677.  
  5678.     This menu sub-item allows you to retrieve messages from files
  5679.     even when online (connected to a host through your TCP/IP
  5680.     software).
  5681.  
  5682. Exclude Duplicate Messages
  5683.  
  5684.     This is a checkmarked menu sub-item.  When checked, duplicate
  5685.     messages (ones that were previously retrieved and stored in one
  5686.     of AEMail's folders), will not be stored.  See the description
  5687.     under the RETRIEVE MESSAGES command for the use and full explanation
  5688.     of the function of this item.
  5689.  
  5690.     The current state of this checkmarked item is saved in the
  5691.     configuration file whenever the "Configuration/Save" menu item is
  5692.     selected.  It can also be set or reset by the General Parameters page
  5693.     on the Configuration Setup Window.
  5694.  
  5695.  
  5696. Delete Host Mail
  5697.  
  5698.     This is a checkmarked menu sub-item.  When checked mail
  5699.     retrieved from your POP Server will be deleted after it is
  5700.     retrieved.  If it is not checked, mail will not be deleted
  5701.     and you will have to use the "Exl Dup Msgs" checkmark item
  5702.     discussed above to insure that a duplicate message are not
  5703.     retrieved the next time you retrieve messages.
  5704.  
  5705.     The current state of this checkmarked item is saved in the
  5706.     configuration file whenever the "Configuration/Save" menu item is
  5707.     selected.  It can also be set or reset by the General Parameters page
  5708.     on the Configuration Setup Window.
  5709.  
  5710.  
  5711.  
  5712.                                TCP/IP menu
  5713.                                -----------
  5714.  
  5715. Start Net
  5716.  
  5717.     This menu item makes connection to your Internet Provider.  It
  5718.     executes the script that has been assigned by the Start Net
  5719.     Tool Type or the TCP/IP page of Configuration Setup.  If
  5720.     no Start Net script has been assigned, the action that is
  5721.     performed is to iconify AEMail.  You can then perform the
  5722.     network connection in what ever manner was provided by your
  5723.     TCP/IP stack software.  Once the connection is made, un-iconify
  5724.     AEMail.
  5725.  
  5726.     When this menu item is selected and a "startnet" script has been
  5727.     assigned, the system will, by default, switch to the workbench
  5728.     screen and execute the "startnet" script.  This allows the initial
  5729.     dialing window to display.  Once your Internet connection has been
  5730.     made the system will switch back to the AEMail screen.
  5731.  
  5732.     You can control the switching to the workbench screen by a check-
  5733.     marked item in the TCP/IP Parameters page on the Configuration
  5734.     Setup Window.
  5735.  
  5736.     If you are using AmiTCP, the script that should be run is
  5737.     AmiTCP:bin/startnet; although the user may specify a different script
  5738.     and path with the STARTNET Tool Type or in the TCP/IP Parameters page
  5739.     on the Configuration Setup Window.
  5740.  
  5741.     If you are using Miami, a "startnet.miami" script has been provided
  5742.     for connecting with your Internet provider.  This is usually run from
  5743.     the AEMail program directory.  This is an AREXX script so you will
  5744.     have to precede the script name with "rx " (see Section IV,
  5745.     CONFIGURATION for setting up your Start Net script).  This is set up
  5746.     automatically with the AEMail install provided a Miami: assignment is
  5747.     in the system.
  5748.  
  5749.     If you are using a TCP/IP stack that does not have a Start Net script
  5750.     (such as TermiteTCP), you should be sure that the Start Net call
  5751.     gadget in the TCP/IP parameters page of the Configuration Setup has
  5752.     been cleared.  Your Internet connection is then done manually as
  5753.     explained above.
  5754.  
  5755.     Once a connection is made to your Internet provider and you have
  5756.     returned to the AEMail screen, a connection will be made to your POP
  5757.     server to see if there are any messages available on the server.  If
  5758.     there are, the following requester will appear:
  5759.  
  5760.                   n Messages Available on the POP Server
  5761.  
  5762.                 Do you wish to receive these messages now?
  5763.  
  5764.     If you click on the [YES] button, those message will be retrieved at
  5765.     this point.  See the RETRIEVE MESSAGES command described in Section
  5766.     VI, COMMAND ICON STRIP above for details on this process.
  5767.  
  5768.     If you click on [NO], no message retrieval will take place at this
  5769.     time.  You will need to retrieve these messages later using the
  5770.     RETRIEVE MESSAGES command icon.
  5771.  
  5772.     After AEMail checks to see if any messages are available on the
  5773.     POP Server, it also checks to see if any messages are in the QUEUED
  5774.     folder (messages queued to be sent).  If there are, the following
  5775.     requester will appear:
  5776.  
  5777.                   You have n messages queued to be sent
  5778.  
  5779.                  Do you wish to send these messages now?
  5780.  
  5781.     If you click on the [YES] button, all of the messages in the QUEUED
  5782.     folder will be sent immediately. If you click on [NO], the queued
  5783.     messages will not be sent.
  5784.  
  5785.     After the connection is made, the following message will be displayed
  5786.     in the screen's title bar:
  5787.  
  5788.         TCP/IP Session started with [your-domain-name].
  5789.  
  5790.     If for any reason the connection can not be made, the following
  5791.     message will be displayed in the screen's title bar:
  5792.  
  5793.         TCP/IP connection to [your-domain-name] failed.
  5794.  
  5795.     The "Start TCP/IP Network Connection" command icon will perform the
  5796.     same operation as the "Start Net" menu item.
  5797.  
  5798. Stop Net
  5799.  
  5800.     This menu item terminates the connection to your Internet Provider.
  5801.     It executes the script that has been assigned by the Stop Net Tool
  5802.     Type or the TCP/IP page of the Configuration Setup.  If no Stop Net
  5803.     script has been assigned, the action that is performed is to iconify
  5804.     AEMail.  You can then terminate the network connection in what ever
  5805.     manner was provided by your TCP/IP stack software.  Once the
  5806.     connection is terminated, un-iconify AEMail.
  5807.  
  5808.     When this menu item is selected and a "stopnet" script has been
  5809.     assigned, the system will terminate the connection silently in
  5810.     the background.  Since no action is required by the user (unlike
  5811.     "startnet"), the screen display will remain on the AEMail screen.
  5812.  
  5813.     If you want to switch to the Workbench screen while the connection is
  5814.     being terminated, you can do this through a check-marked item in the
  5815.     TCP/IP Parameters page on the Configuration Setup.
  5816.  
  5817.     If you are using AmiTCP, the script that should be run is
  5818.     AmiTCP:bin/stopnet; although the user may specify a different script
  5819.     and path with the STOPNET Tool Type or in the TCP/IP Parameters page
  5820.     on the Configuration Setup.
  5821.  
  5822.     If you are running Miami, a "stopnet.miami" script has been provided
  5823.     for terminating the connection with your Internet provider.  This
  5824.     script is usually run from the AEMail program directory.  This is an
  5825.     AREXX script so you will have to precede the script name with "rx "
  5826.     (see Section IV, CONFIGURATION for setting up your Stop Net script).
  5827.     This is set up automatically with the AEMail install provided a Miami:
  5828.     assignment is in the system.
  5829.  
  5830.     If you are using a TCP/IP stack that does not have a Stop Net script
  5831.     (such as TermiteTCP), you should be sure that the Stop Net call gadget
  5832.     in the TCP/IP parameters page of the Configuration Setup has been
  5833.     cleared.  Your Internet connection is then terminated manually as
  5834.     explained above.
  5835.  
  5836.     The following messages will be displayed in the screen's title bar
  5837.     when the connection is terminated:
  5838.  
  5839.         TCP/IP session with [your-domain-name] terminated.
  5840.  
  5841.     The "Terminate TCP/IP Network Connection" command icon will perform
  5842.     the same operation as the "Stop Net" menu item.
  5843.  
  5844. TCP Logging File
  5845.  
  5846.     This has three submenu items for controlling your TCP Logging file.
  5847.     Please read Section X. AEMAIL FILES, TCP Trace Log File for how to
  5848.     read the entries in this file.
  5849.  
  5850.     The sub-menu items are:
  5851.  
  5852.     Active
  5853.  
  5854.         This is a checkmarked menu sub-item which indicates whether the
  5855.         TCP Logging is active or not.  If a TCP Logging File has not been
  5856.         defined with the Paths page of the Configuration Setup, this
  5857.         sub-item is ghosted.
  5858.  
  5859.         Clicking on this item when it is not checkmarked will activate TCP
  5860.         Logging.  Clicking on it when it is checkmarked will deactivate
  5861.         logging.
  5862.  
  5863.     Purge
  5864.  
  5865.         This is a handy way to delete all previous TCP Logging entries.
  5866.         "Purge" will delete the current logging file and open another file
  5867.         with the same name if logging is active.  If logging is not
  5868.         active, the current logging file will be deleted, but a new file
  5869.         will not be opened until the Active sub-item is checkmarked.
  5870.  
  5871.         This menu item can be used whether the logging file is currently
  5872.         active or not.
  5873.  
  5874.     Display/Edit...
  5875.  
  5876.         "Display/Edit" will call your editor to display the current TCP
  5877.         logging file.  The logging file MUST NOT be Active in order to
  5878.         display or edit it.  If it is active you will get a requester that
  5879.         informs you that you can't display the file beause it is active.
  5880.         If this happens, de-activate it by turning off the Active
  5881.         checkmark and then try the "Display/Edit" again.
  5882.  
  5883.         If a TCP Logging file has not been defined in the Paths page of
  5884.         the Configuration Setup, you will receive a requester saying that
  5885.         it is not present.
  5886.  
  5887.         NOTE:  The TCP logging file can become quite large and it may take
  5888.         some time for your editor to bring in the file.  Some editors are
  5889.         slower than others in this regard.  If you are using the AmigaDos
  5890.         editor (Ed), you will see a series of astericks (@) moving across
  5891.         the screen as the file is being read in.  You might want to
  5892.         periodically purge the file (if it is always active), to prevent a
  5893.         very large TCP Log file from being created.
  5894.  
  5895.                               ARexx/DOS menu
  5896.                               --------------
  5897.  
  5898. Send AREXX/DOS Command...
  5899.  
  5900.     This will bring up a requester that looks like this:
  5901.  
  5902.          |=====================================================|
  5903.          |o| Send AREXX/DOS Command                            |
  5904.          |=====================================================|
  5905.          |                                                     |
  5906.          | |@| AREXX |[                         ][V][CLR][REQ] |
  5907.          |                                                     |
  5908.          | [ ] Opens On Workbench   [X] Execute Asynchronously |
  5909.          |                                                     |
  5910.          | [  OK  ]                                 [ CANCEL ] |
  5911.          |=====================================================|
  5912.  
  5913.     The cycle gadget has two states: AREXX and DOS.  Select the kind of
  5914.     command (execute script or program) you want to start.  The string
  5915.     gadget to the right of the cycle gadget is for entering the command.
  5916.     Unless the command (program or script) is in the same directory as the
  5917.     AEMail program or REXX: (if it is an ARexx command script), you must
  5918.     include the full path name.  The last command you executed will always
  5919.     appear in this string gadget when you first call up the requester.
  5920.  
  5921.     The [V] gadget is used to call up a listview of the past commands you
  5922.     have executed.  You can click on one of these if you want to use a
  5923.     previous command.  The last command you executed will always appear at
  5924.     the top of the list.  The list of commands (up to the last 10) will be
  5925.     maintained even after you quit AEMail.  This list will close when you
  5926.     click on any item in the list or, if you don't want any of the items,
  5927.     when you click into any of the other gadgets in the requester.
  5928.  
  5929.     Yhe [CLR] gadget will clear the string gadget and the [REQ] will call
  5930.     up a file requester with which you can select the program or script
  5931.     you want to execute.  The initial directory that is used in the
  5932.     requester is the PROGDIR: if it is a DOS command or REXX: if it is an
  5933.     ARexx command.
  5934.  
  5935.     The two checkmark gadgets on the second row are used for DOS commands
  5936.     only.  They will be disabled for ARexx commands.
  5937.  
  5938.     If "Opens on Workbench" is checked, a switch will be made to the
  5939.     Workbench screen when the command is executed.  This is not necessary
  5940.     for ARexx command since there is an AEMail ARexx command that will do
  5941.     this.
  5942.  
  5943.     The "Execute Asynchronously" checkmark gadget is used to execute the
  5944.     DOS command in the background.  This will allow AEMail to function
  5945.     when the program that is called is being executed. This item is, by
  5946.     default, checkmarked.  If for some reason you want AEMail to freeze
  5947.     while the command (program) is being executed, you can un-checkmark
  5948.     this item.  Since all ARexx command automatically execute in the
  5949.     background, this item is uneccessary for ARexx command scripts.
  5950.  
  5951.     When you are ready to execute the command, click on [OK].  If you want
  5952.     to cancel the operation, click on [CANCEL].
  5953.  
  5954.     You can also bind ARexx or DOS commands to a function key.  You can
  5955.     have up to 40 selections since the Shift, CTRL, and ALT keys can be
  5956.     used in conjunction with the function keys.  This is done with the
  5957.     ARexx Page of the Configuration Setup Window (See Section IV.
  5958.     Configuration).  When you press the appropriate function key the ARexx
  5959.     or DOS command bonded to it will be executed.
  5960.  
  5961. Send Last Command
  5962.  
  5963.     This menu item will send the last ARexx or DOS command sent by "Send
  5964.     AREXX/DOS command" without bringing up the "Send AREXX/DOS command"
  5965.     requester.  It will not send the last command activated by a function
  5966.     key.
  5967.  
  5968.  
  5969. Commands Specified by ARexx Configuration Page
  5970.  
  5971.     This portion of the ARexx/DOS menu consists of those items specified
  5972.     by the ARexx Page of the Configuration Setup.  A menu item will be
  5973.     created for each ARexx/DOS command for which a "Menu Title" is
  5974.     specified.  If no "Menu Title" is specified, no menu item will be
  5975.     created.
  5976.  
  5977.     Each of these menu items have the same effect as if the corresponding
  5978.     function key is pressed.
  5979.  
  5980.     Depending on the number of commands that are defined, you might not
  5981.     want to give all of them a "Menu Title" to avoid having too many menu
  5982.     items specified.
  5983.  
  5984.                            VIII. AEMAIL WINDOWS
  5985.  
  5986.                         Configuration Setup Window
  5987.                         --------------------------
  5988.  
  5989. See Section IV. CONFIGURATION for a description of the Configuration
  5990. Setup Window.
  5991.  
  5992.  
  5993.                             Folder List Window
  5994.                             ------------------
  5995.  
  5996. The Folder List window will be displayed in the lower portion of the
  5997. screen when AEMail is first loaded and whenever you click on the DISPLAY
  5998. FOLDER LIST icon in the Command Icon Strip.
  5999.  
  6000. The Folder List window looks like the following:
  6001.  
  6002. =====================================================================
  6003.  
  6004.                             Folder List
  6005.  
  6006. Name      Description of Folder                     Not Read Total
  6007. ---------------------------------------------------------------------
  6008. INBOX     Messages Received                            nnnnn nnnnn| |
  6009. PENDING   Messages composed and pending for action           nnnnn| |
  6010. QUEUED    Messages Queued to be sent                         nnnnn| |
  6011. SENT      Messages that have been sent                       nnnnn| |
  6012. xxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx nnnnn nnnnn| |
  6013. xxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx nnnnn nnnnn| |
  6014.                                                                   | |
  6015. =====================================================================
  6016.  
  6017. The folder list is a scrolling list.  Double clicking on any of the
  6018. folders in the list will bring up the Message List window for that folder.
  6019. If the Folder Icon strip is also being displayed, double clicking on any
  6020. particular folder icon will also bring up the message list for that
  6021. folder.
  6022.  
  6023. If there are too many folders to fit in the window, you can scroll the
  6024. list by using the scroll bar, clicking on the up or down arrows below the
  6025. scroll bar, or by using the up or down cursor keys.
  6026.  
  6027. Additionally the following keys can be used to move the list as follows:
  6028.  
  6029.     "Home" or "ALT Cursor Up" moves the listview to the top.
  6030.     "End" or "ALT Cursor Down" moves the listview to the botton.
  6031.     "PgUp" or "Shift Cursor Up" pages the listview one "page" up.  The
  6032.         top line of the previous page will be displayed as the bottom
  6033.         line of the new page.
  6034.     "PgDn" or "Shift Cursor Down" pages the list view one "page" down.
  6035.         The bottom line of the previous page will be displayed as the
  6036.         top line of the new page.
  6037.     The cursor up/down keys on the keypad will have the same action as
  6038.         the normal cursor keys with the exception of the shift
  6039.         feature.
  6040.  
  6041. Single clicking on a item in the list or folder icon merely selects that
  6042. folder.  The selected folder is then the folder referenced by the Folders
  6043. Menu group items (Edit.., Delete..., Set Sort Key ...) and by such
  6044. commands as Message Delete, Message Copy, Message Transfer, or Message
  6045. Select All/NONE.
  6046.  
  6047. One of the folders is always active (selected).  On program startup, the
  6048. active folder will be INBOX.  You can always tell the current active
  6049. folder by the depressed frame around the folder icon.
  6050.  
  6051.  
  6052.                            Message List Window
  6053.                            -------------------
  6054.  
  6055. The Message List window will be displayed in the lower portion of the
  6056. screen whenever you double click on either an item in the folder list or
  6057. one of the folder icons.
  6058.  
  6059. You can also bring up the current folder list by clicking on the
  6060. "Display Current Folder's Message List" command icon in the command icon
  6061. tool bar.  The previous and next folder's message list can also be
  6062. displayed from the command icon tool bar.
  6063.  
  6064. The Message List looks like the following:
  6065.  
  6066. ========================================================================
  6067.  
  6068.     Message List for [folder-name] Folder ([folder Description...])
  6069.  
  6070.  FLGS Date       Time  From           Size Subject     (nnn messages)
  6071. ------------------------------------------------------------------------
  6072.  NARF MM/DD/YYYY HH:MM xxxxxxxxxxxxx xxxxx xxxxxxxxxxxxxxxxxxxxxxxxxx| |
  6073. *NARF MM/DD/YYYY HH:MM xxxxxxxxxxxxx xxxxx xxxxxxxxxxxxxxxxxxxxxxxxxx| |
  6074.  . . . . .                                                           | |
  6075.  NARF MM/DD/YYYY HH:MM xxxxxxxxxxxxx xxxxx xxxxxxxxxxxxxxxxxxxxxxxxxx| |
  6076.                                                                      | |
  6077. ========================================================================
  6078.  
  6079.  
  6080. The column header line displays the number of messages in the folder as
  6081. (nnn messages).  This is the total number of messages including those
  6082. marked for deletion.
  6083.  
  6084. The message descriptions are presented in a scrollable list.  You can
  6085. scroll the list by using the scroll bar, clicking on the up or down arrows
  6086. below the scroll bar, or by using the up or down cursor keys.
  6087.  
  6088. Additionally the following keys can be used to move the list as follows:
  6089.  
  6090.     "Home" or "ALT Cursor Up" moves the listview to the top.
  6091.     "End" or "ALT Cursor Down" moves the listview to the botton.
  6092.     "PgUp" or "Shift Cursor Up" pages the listview one "page" up.  The
  6093.         top line of the previous page will be displayed as the bottom
  6094.         line of the new page.
  6095.     "PgDn" or "Shift Cursor Down" pages the list view one "page" down.
  6096.         The bottom line of the previous page will be displayed as the
  6097.         top line of the new page.
  6098.     The cursor up/down keys on the keypad will have the same action as
  6099.         the normal cursor keys with the exception of the shift
  6100.         feature.
  6101.  
  6102.  
  6103. The meaning of the various fields of each message description are as
  6104. follows:
  6105.  
  6106.     FLGS:   (starts in the 2nd column)
  6107.             N indicates an unread message
  6108.             A indicates a message with attachments (NOT IMPLEMENTED)
  6109.             R indicates the message is a reply
  6110.             F indicates the message is a forwarded message.
  6111.             D (in the same position as N) indicates the message is
  6112.               a deleted message.
  6113.             L (in the same position as N) indicates that a message in
  6114.               either the PENDING or QUEUED folder is locked so it will not
  6115.               be sent until the lock is removed (it is unlocked).
  6116.  
  6117.     Date:   This is the message date from the DATE:  header in the form of
  6118.             MM/DD/YYYY (2 digit month, 2 digit day, and the 4 digit year).
  6119.  
  6120.     Time:   This is the time the message was received in the form of HH:MM
  6121.             (2 digit hour, 2 digit minute).  Time uses a 24 hour clock.
  6122.  
  6123.     From:   Is the Real Name (if present) from either the From:  or To:
  6124.             header.  If the folder represents messages being sent from
  6125.             AEMail (PENDING, QUEUED, SENT) then this field will be headed
  6126.             "To" and the To:  header will be used.  If the Real Name is
  6127.             not present in the header, then the UserID will be used
  6128.             instead.  If a Nickname is being used for a message being
  6129.             sent, then the Nickname will appear.
  6130.  
  6131.     Size:   This is the size, in bytes, of the message in the form nnn,nnn.
  6132.             If the size exceeds 999,999 bytes then ***,*** will appear.
  6133.             The size includes the size of the message with all its
  6134.             attachments.
  6135.  
  6136.     Subject:  Up to 50 characters from the Subject:  header after RE:  and
  6137.             (fwd) are stripped.  You can tell if the message is forwarded
  6138.             or is a reply by examining the FLGS field.  RE:  and (fwd) are
  6139.             stripped from the Subject:  header to allow sorting to place
  6140.             all messages with the same subject (whether original, replied,
  6141.             or forwarded) together.  You can also control where 'replied'
  6142.             and 'forwarded' messages go in the list since these use
  6143.             separate sorting criteria.  The number of characters fitting
  6144.             in the subject field depends on the display mode you are using.
  6145.  
  6146. An asterick (*) in the first position indicates that the message is
  6147. selected.  This position will be blank if the message is not selected.
  6148.  
  6149. The Message list can be sorted under a number of different categories (see
  6150. Set Sort Keys window below).
  6151.  
  6152. Double clicking on any message in the message list will bring up the
  6153. message display window for that message.
  6154.  
  6155. A single click will highlight and select the message.  An asterick will
  6156. appear in the first column of the line indicating the message is selected.
  6157. You can click on another message to highlight and select that message.
  6158. Clicking on a message that is already selected will deselect the message.
  6159.  
  6160. If you are running under AmigaDOS 3.0 or higher, you can also select (or
  6161. deselect) a group of messages by drag selecting.  Place the cursor over
  6162. the message you first want to select or deselect and then, holding down
  6163. the left mouse button, drag either up or down.  Whether selecting or
  6164. deselecting occurs depends on the state of the first message you select.
  6165.  
  6166. Only one message is highlighted.  If that message is selected it will be
  6167. considered the current message to reply to, forward, or edit when
  6168. composing messages.
  6169.  
  6170. Other operations such as DELETE/UNDELETE MESSAGE, SAVE/EXPORT MESSAGES,
  6171. COPY MESSAGE, TRANSFER MESSAGE, PRINT SELECTED MESSAGES, SEND MESSAGE
  6172. IMMEDIATELY, and QUEUE MESSAGE FOR LATER DELIVERY will use the entire
  6173. selected list of messages.
  6174.  
  6175.  
  6176.                        Folder Configuration Window
  6177.                        ---------------------------
  6178.  
  6179. The Folder Configuration window will be displayed over the entire screen
  6180. below the top title line when either the "New..." or "Edit..." menu items
  6181. are selected from the Folders menu.
  6182.  
  6183. The Folder Configuration window looks like the following:
  6184.  
  6185. =====================================================================
  6186.  
  6187.        Folder Name: [         ]   (1 - 9 Characters only) [SORT KEYS]
  6188.  
  6189. Folder Description: [            __                                 ]
  6190.                                 |  |___
  6191.          Tab Color: [@|  Red  | |______| [ ] Folder for Sent Messages
  6192.  
  6193.   =================================================================
  6194.   |Filter Parameters for Selecting Messages                       |
  6195.   =================================================================
  6196.   |                                                               |
  6197.   | [ ] Not [ ] Start Group                       [ ] Ignore Case |
  6198.   |                                                               |
  6199.   | For [@|    To:     ]               [@|   Contains    ] [] END |
  6200.   |                                                               |
  6201.   | Search [                                             ] [] AND |
  6202.   |                                                               |
  6203.   | [ ] End Group                                          [] OR  |
  6204.   |  ___________________________________________________________  |
  6205.   | |                                                         | | |
  6206.   | |                                                         | | |
  6207.   | |                                                         | | |
  6208.   | |                                                         | | |
  6209.   | |                                                         | | |
  6210.   | |                                                         | | |
  6211.   | |                                                         | | |
  6212.   | |                                                         |^| |
  6213.   | |_________________________________________________________|V| |
  6214.   |                                                               |
  6215.   |                            [ Add ] [Insert] [Modify] [Delete] |
  6216.   |                                                               |
  6217.   =================================================================
  6218.  
  6219.               [ SAVE ]                  [CANCEL]
  6220.  
  6221. ====================================================================
  6222.  
  6223. If you are editing an existing folder, the Folder Name will be filled in,
  6224. but the string gadget will be disabled.  You will not be able to modify
  6225. it.
  6226.  
  6227. If you are creating a new folder you must name it with a 1 to 9 character
  6228. folder name.  This will appear below the folder icon in the folder strip
  6229. and in the Folder List.  There are certain characters that are illegal
  6230. when creating folder names.  Because a special configuration file is
  6231. created for each folder called [folder-name].cnfg, any character that
  6232. would be illegal as part of a file name is illegal in creating a file
  6233. name.  These include ':', '/' and '\'.  Also the name "folder" (case 
  6234. insensitive) is illegal since folder.cnfg is the master list of folders.
  6235.  
  6236. The [SORT KEYS] button is used to call the Set Sort Keys window (see
  6237. below) to set the sort keys for the folder.
  6238.  
  6239. The folder description can be up to 99 characters, but of course that many
  6240. characters will never appear anywhere.  Up to 52 characters will appear in
  6241. the folder list display under "Description of Folder".  This will also
  6242. appear in the contextual help line in the window bar preceded by "Folder
  6243. for"
  6244.  
  6245. The Tab Color is a cycle gadget with the following possible values:  Red,
  6246. Green, Blue, Yellow, Orange, Magenta, Brown, or Purple.  This provides a
  6247. color on the folder tab to help classify the folders according to the
  6248. user's preferences.  The actual tab color will be displayed to the right
  6249. of this cycle gadget.
  6250.  
  6251. The checkbox gadget marked "Folder for Sent Messages" is used to indicate
  6252. when a folder is for messages that have been sent or ready to be sent
  6253. rather than in-coming folders.  The PENDING, QUEUED, and SENT folders all
  6254. have this box checked.
  6255.  
  6256. The special window in the center of the Folder Configuration window is
  6257. used to set filter parameters for this folder.  A full description of how
  6258. this works is given below under "Filter Selection Window".  The filtering
  6259. parameters are used to distribute in-coming messages to various folders.
  6260. For the INBOX, these filters have a special meaning which will reject any
  6261. message meeting the filtering criteria.  The heading for the filtering
  6262. criteria for the INBOX will read "Filtering Parameters for Rejecting
  6263. Messages" instead of "Filtering Parameters for Selecting Messages".
  6264.  
  6265. Since filtering can only occur with in-bound messages, folders for sent
  6266. messages can not have filtering parameters associated with them.  For all
  6267. folders for "sent" messages, all of the gadgets in the filtering window
  6268. will be disabled preventing the entry of any filtering information.  This
  6269. is true of the PENDING, QUEUED, and SENT folders as well as any folders that
  6270. have been added with the "Folder for Sent Messages" box checked.
  6271.  
  6272. Finally, you are given the choice of canceling the operation or saving the
  6273. folder data in the folder.config file with the [CANCEL] and [SAVE]
  6274. buttons.
  6275.  
  6276.                          Filter Selection Window
  6277.                          -----------------------
  6278.  
  6279. The filter selection window for setting filter parameters looks like this:
  6280.  
  6281.     =================================================================
  6282.     |Filter Parameters for Selecting Messages                       |
  6283.     =================================================================
  6284.     |                                                               |
  6285.     | [ ] Not [ ] Start Group                       [ ] Ignore Case |
  6286.     |                                                               |
  6287.     | For [@|    To:     ]               [@|   Contains    ] [] END |
  6288.     |                                                               |
  6289.     | Search [                                             ] [] AND |
  6290.     |                                                               |
  6291.     | [ ] End Group                                          [] OR  |
  6292.     |  ___________________________________________________________  |
  6293.     | |                                                         | | |
  6294.     | |                                                         | | |
  6295.     | |                                                         | | |
  6296.     | |                                                         | | |
  6297.     | |                                                         | | |
  6298.     | |                                                         | | |
  6299.     | |                                                         | | |
  6300.     | |                                                         |^| |
  6301.     | |_________________________________________________________|V| |
  6302.     |                                                               |
  6303.     |                            [ Add ] [Insert] [Modify] [Delete] |
  6304.     |                                                               |
  6305.     =================================================================
  6306.  
  6307. The gadgets in the top half of the window are used to enter filtering
  6308. parameters.  The first two checkmark gadgets ([ ] Not, [ ] Start Group)
  6309. and the [ ] End Group checkmark gadget at the bottom of the group are
  6310. currently disabled.  They are designed to be used for advanced selection
  6311. criteria that will be added to a future version of AEMail.
  6312.  
  6313. The cycle gadget which is prefaced with "For" is used to select the header
  6314. that you want to check.  This gadget has the following states:
  6315.  
  6316.     To:
  6317.     From:
  6318.     Reply-To:
  6319.     Subject:
  6320.     cc:
  6321.     bcc:
  6322.     Date:
  6323.     Msg is Reply
  6324.     Msg w/Attachments
  6325.     Msg is Forwarded
  6326.     Other Message Hdrs      (Registered Users only)
  6327.     Message Body            (Registered Users only)
  6328.  
  6329. Note: it is unlikely that you would see the bcc: header in an incoming
  6330. message even though it is contained in the header list.
  6331.  
  6332. To the right of this is a cycle gadget which specifies the condition this
  6333. header will be checked for.  For the To:, From:, Reply-To: Subject:, cc:,
  6334. and bcc:  headers, Other Message Hdrs, and Message Body the condition can
  6335. be either:
  6336.  
  6337.     Contains, or
  6338.     Does Not Contain
  6339.  
  6340. For the Date: header it can be one of the following conditions:
  6341.  
  6342.     Equal
  6343.     Not Equal
  6344.     Greater Than
  6345.     Greater Than / Equal
  6346.     Less Than
  6347.     Less Than / Equal
  6348.  
  6349. and for Msg is Reply, Msg w/Attachments, Msg is Forwarded it can be:
  6350.  
  6351.     Is Present
  6352.     Is Not Present
  6353.  
  6354. The argument to be searched against is entered into the string gadget that
  6355. is titled "Search".  For the To:, From:, Reply-To:, Subject:, cc:, and
  6356. Bcc: headers and the "Other Message Hdrs" and "Message Body" you can
  6357. enter an argument that has wild cards.  The wild cards that are used are
  6358. as follows:
  6359.  
  6360.     ?   matches any single character.
  6361.     c*  matches zero or more occurances of character c.  If an unknown
  6362.         character is to be matched you can use ?*.
  6363.     c+  matches one or more occurances of character c (at least one
  6364.         occurance of c must be present).
  6365.     \?  matches the character ?.
  6366.     \*  matches the character *.
  6367.     \+  matches the character +.
  6368.  
  6369. Any other characters must match exactly (except that case can be ignored -
  6370. see below).  The match can occur anywhere in the header.  The following
  6371. are some examples of how the match occurs:
  6372.  
  6373.     abc     matches "abc", "abcdef", or "xxabc"
  6374.     ab*c    matches "ac", "abc", "abbc", or "abbbc", etc.  Characters may
  6375.             be present either before or after the match.
  6376.     ab+c    matches "abc", "abbc", or "abbbc", etc.  Characters may be
  6377.             present either before or after the match.  This will not match
  6378.             "ab+c".  You would have to use "ab\+c" for this to occur.
  6379.     ab?*    matches a substring starting with "ab" and ending with "c".
  6380.             Characters may be present either before or after the match.
  6381.     ab\*c   matches "ab*c" only.  However charcters may be either before
  6382.             or after the match.
  6383.  
  6384. WARNING:  Please pay particular attention to the characters +, ?, and *.
  6385. If any of these characters appear in the information to be matched, you
  6386. must use \+, \?, or \* in the argument if you want an exact match to
  6387. occur.
  6388.  
  6389. If "Other Message Hdrs" is used, you probably would want to use the Header
  6390. designation as part of the search argument.
  6391.  
  6392. Searching on header data will search the entire string of characters
  6393. contained within that header even though that header may span multiple
  6394. lines.  This means that if an address you want to locate is contained in
  6395. the nth line of the To: header, it will be found.
  6396.  
  6397. When searching data in the message body, the entire argument must be found
  6398. in a single line of the body.  If you are searching for a multiple word
  6399. phrase which may be broken up onto more than one line, you should specify
  6400. multiple arguments with AND separating the arguments.
  6401.  
  6402. If you want to ignore the case of the header or message body data when the
  6403. comparison is made check the "Ignore Case" item.  The "Ignore Case" item
  6404. will only ignore the case of the 26 alphabetic characters of the
  6405. American/English alphabet.  It will not ignore the case of special
  6406. characters used in forign alphabets although these special characters can
  6407. be used in the Search criteria.
  6408.  
  6409. The Search argument for the Date: header can be of one or two formats.
  6410. The first format is either:
  6411.  
  6412.     dd mmm yyyy or
  6413.     mmm dd yyyy
  6414.  
  6415. mmm is the three character month abbreviation:  jan, feb, mar, apr, may,
  6416. jun, jul, aug, sep, oct, nov, or dec.  You can enter either upper case,
  6417. lower case, or mixed case month abbreviations (i.e., jan, JAN, or Jan are
  6418. all o.k.).
  6419.  
  6420. dd is the numeric digits for the day of the month and yyyy must be the
  6421. full 4 digit year.  If you want any day of a particular month to be used,
  6422. leave off the dd parameter.  Likewise, using just the 4 digit yyyy will
  6423. accept any month and day for that year.
  6424.  
  6425. The absence of any of the elements of the date (mmm, dd, or yyyy) will
  6426. indicate that that particular element should not be checked.  As an
  6427. example:  if you want only messages for the month of September to be
  6428. placed in a particular folder you would enter:
  6429.  
  6430.     sep
  6431.  
  6432. by itself and the condition would be entered as "equal to".  This would
  6433. capture messages with a Date header of September of any year (Sep 1997,
  6434. Sep 1998, etc.).  If you were interested in messages with a Date:  header
  6435. of September of 1997 you would enter:
  6436.  
  6437.     sep 1997
  6438.  
  6439. An alternate method of entering the date would be:
  6440.  
  6441.     mm/dd/yy    or
  6442.     mm/dd/yyyy  or
  6443.     mm-dd-yy    or
  6444.     mm-dd-yyyy
  6445.  
  6446. mm is a one or 2 digit month (1 or 01 to 12), dd is a one or 2 digit day
  6447. (1 or 01 to 31) and yy is either a 2 digit or 4 digit year. 0 is invalid
  6448. for any of the mm, dd, or yy.  If you want to indicate the absence of any
  6449. of the elements use xx or XX.  As an example, to capture messages with a
  6450. Date header equal to any day within September 1997 you could enter:
  6451.  
  6452.     09/xx/97
  6453.  
  6454. Before the search for a Date: header is made, the date in the Date: header
  6455. is converted to an internal format.  The search argument is also converted
  6456. to this same internal format so that the match can be performed correctly.
  6457.  
  6458. The Search argument for Msg is Reply, Msg w/Attachments, and Msg is Forwarded
  6459. is ignored.
  6460.  
  6461. The "END", "AND, and "OR" gadgets are used to indicate that this is the
  6462. last comparison argument (END), or that there is another comparison
  6463. argument following this with either an AND or OR relationship.
  6464.  
  6465. Some examples of specific types of filtering parameters are given below.
  6466.  
  6467. The list view in the lower half of the window lists the comparison arguments.
  6468. Each comparison arguement is listed on two lines.  The first line shows
  6469. the header to be checked and the comparison criteria in the following
  6470. format:
  6471.  
  6472. FOR header-name comparison-criteria (ignoring case)
  6473.  
  6474. (ignoring case) will not be present if "Ignore Case" is not checked.
  6475.  
  6476. The second line will show the search argument surrounded by quote (")
  6477. marks.  It will be followed by AND or OR if either of these were
  6478. specified.  If "Ignore Case" was checked, the Search argument will be in
  6479. all lower case characters no matter how it was entered in the Search:
  6480. string gadget.
  6481.  
  6482. To add a selection criteria to the list, enter the appropriate items in
  6483. the gadgets at the top of the window and click on the [ Add ] gadget at
  6484. the bottom of the window.  That item will be transfered to the listview at
  6485. the end of the current list of items.
  6486.  
  6487. To modify or delete an item, click on the item in the listview.  Clicking
  6488. on either the first or second line of any item in the list is acceptable.
  6489. The information from the listview will be transferred to the gadgets at
  6490. the top of the window.  Then make the modifications you want (for modify)
  6491. and click on either the [Modify] or [Delete] gadgets at the bottom of the
  6492. window.
  6493.  
  6494. To insert an item into the list, enter the data in the gadgets at the top
  6495. of the window as you did to add an item.  This time click on the [Insert]
  6496. gadget.  The words "Click on item you want to insert IN FRONT OF!" will
  6497. appear in yellow at the top of the listview.  Now, as instructed, click on
  6498. the item you want the selection criteria to be inserted in front of.  This
  6499. allows you to insert at the head of the list by clicking on the first item
  6500. in the list.  Clicking on either the first or second line of any item in
  6501. the list is acceptable.
  6502.  
  6503. All of the selection criteria except for the last item must have an AND or
  6504. OR relationship to the criteria following.  You can have relationships as
  6505. follows:
  6506.  
  6507.     a OR b OR c
  6508.  
  6509. indicating that if any of the conditions (a, b, or c) are met that message
  6510. will be selected for that particular folder, or
  6511.  
  6512.     a AND b AND c
  6513.  
  6514. indicating that all of the conditions must be met for that message to be
  6515. selected.
  6516.  
  6517. Be careful of mixing AND and OR conditions.
  6518.  
  6519.     a OR b AND c
  6520.  
  6521. will work but
  6522.  
  6523.     b AND c OR a
  6524.  
  6525. will not work correctly.
  6526.  
  6527. Conditions are checked serially.
  6528.  
  6529. In the first example above, if condition a is not met, then b will be
  6530. checked.  If b is not met no selection is made; however, if condition c is
  6531. also met, the message will be selected.  If condition a is met the
  6532. message will be selected and the b or c conditions are not checked.
  6533.  
  6534. In the second example, if condition b is not met, no further check will be
  6535. made so that even if a is met, the message will not be selected.  In this
  6536. example condition a will never be checked.
  6537.  
  6538. Advanced selection is designed to get around this problem.  HOWEVER, THIS
  6539. ADVANCED SELECTION HAS NOT BEEN IMPLIMENTED AS YET!  AND WHEN IT IS
  6540. IMPLIMENTED, IT WILL ONLY BE AVAILABLE TO REGISTERED USERS.
  6541.  
  6542. With advanced selection you will be able to group items in this manner:
  6543.  
  6544.     (a AND b) OR (c AND d)
  6545.  
  6546. conditions a and b are a group and conditions c and d are a group.  The
  6547. checkmarked items "Start Group" and "End Group" are used to specify the
  6548. first item in a group and the last item in a group.  You will also be able
  6549. to embed groups within groups such as
  6550.  
  6551.     (a AND b AND (c OR d))
  6552.  
  6553. and use a not condition for a group such as
  6554.  
  6555.     (a AND b AND NOT (c OR d))
  6556.  
  6557. or simply
  6558.  
  6559.     NOT (a OR b)
  6560.  
  6561. Filtering Restrictions.  Currently the following restriction is placed on
  6562. filtering.  This restriction will be lifted in a later release of AEMail.
  6563.  
  6564. Advanced selection (grouping selection criteria as described above), can
  6565. not be done.
  6566.  
  6567. Other selection criteria (such as size of message) may be added later.
  6568.  
  6569.                    Examples of using Message Filtering
  6570.                    ===================================
  6571.  
  6572. How would you use message filtering?  Here is a practical example of how I
  6573. use it.  As you all know, when you implement a new version of AEMail and
  6574. send your first message a special notification message is sent to me
  6575. indicating the version you are using.  This notification message is stored
  6576. in a special folder for notification messages that I have received.  All
  6577. of the notification messages indicate what they are in the Subject:
  6578. header.  However, over the development of AEMail, the format of this
  6579. subject header has changed.  Before version 1.10 the Subject header looked
  6580. like this:
  6581.  
  6582.     Subject: Registration of AEMAIL (Amiga EMAIL), Version x.xx
  6583.  
  6584. From version 1.10 through version 1.15, the Subject header looked like
  6585. this:
  6586.  
  6587.     Subject: AEMAIL Version x.xx Registration
  6588.  
  6589. After version 1.15 the Subject header looked like this:
  6590.  
  6591.     Subject: AEMAIL Version x.xx Notification
  6592.  
  6593. Since I am still receiving notification messages back to version 1.03, I
  6594. wanted all such notification messages to go into the same folder.  The
  6595. selection criteria for this folder was set to the following:
  6596.  
  6597.     For Subject: Contains (ignoring case)
  6598.     "aemail version ???? registration" OR
  6599.  
  6600.     For Subject: Contains (ignoring case)
  6601.     "aemail version ?* notification" OR
  6602.  
  6603.     For Subject: Contains (ignoring case)
  6604.     "registration of aemail (amiga email), version"
  6605.  
  6606. Notice how I handled the variable of the version number in each case.  In
  6607. the first criteria I used a fixed replacement wild card (????) to specify
  6608. the version number.  In the second criteria I used a variable replacement
  6609. wild card (?*) and in the third criteria I did not use any wild card for
  6610. the version number replacement.  That is because the version number occurs
  6611. at the end of the line.
  6612.  
  6613. Another use of filtering can be used if you are subscribed to a listserve.
  6614. The example I will show you is for the Miami list serve.  Miami actually
  6615. has two listserves: "miami-talk-ml@nordicglobal.com" and
  6616. "miami-announce-ml@nordicglobal.com".  The To: address usually reflects
  6617. which listserve the message is coming from but the Reply-To: address
  6618. always reflects "miami-talk-ml@nordicglobal.com".
  6619.  
  6620. If you want the folder to include all messages from both listserves you
  6621. can set the following criteria for the that folder:
  6622.  
  6623.     For Reply-To: Contains (ignoring case)
  6624.     "miami-talk-ml@nordicglobal.com"
  6625.  
  6626. If you set up two folders, one for the "talk" message list and the other
  6627. for the "announcement" message list you could set the "talk" folder to
  6628. reflect the following criteria:
  6629.  
  6630.     For To: Contains (ignoring case)
  6631.     "miami-talk-ml@nordicglobal.com"
  6632.  
  6633. and the "announcement" folder as follows:
  6634.  
  6635.     For To: Contains (ignoring case)
  6636.     "miami-announce-ml@nordicglobal.com"
  6637.  
  6638. If messages meet the selection criteria for two different folders, the
  6639. first folder in the folder list which meets the criteria will be selected.
  6640. So, if you were to have two folders set up as described above (one for
  6641. "talk" messages and one for "announcement" messages) and you used the
  6642. Reply-To: address instead of the To: address as the selection criteria for
  6643. the "talk" folder and if the "talk" folder was first, all of the
  6644. "announcement" messages would go in the "talk" folder.  However, if the
  6645. "announcement" folder was first, then the messages would be distributed to
  6646. the correct folders.
  6647.  
  6648. You will find that the clipboard capability is very helpful in setting up
  6649. your filtering conditions.  If there is a particular header that you want
  6650. selected, display the message that has that header, and then double click
  6651. on the header in the message.  Edit out the header designator (To:, From:,
  6652. Subject:, etc) and save it to the clipboard.  You can save various items
  6653. changing the clipboard unit for each item.  Then when you are in the
  6654. Folder Configuration window, select the Search string gadget and use Right
  6655. Amiga U to call up the clipboard list.  Then double click on the item you
  6656. want to select on.  It will then be automatically pasted into the Search
  6657. string gadget.
  6658.  
  6659. As was stated in the earlier description of the Filter Selection Window,
  6660. the window for the INBOX is used to EXCLUDE messages meeting the INBOX
  6661. criteria from entering your system.  Use this with CARE!  If you exclude a
  6662. message and you are deleting messages from you POP server, YOU WILL NEVER
  6663. SEE THAT MESSAGE!
  6664.  
  6665.  
  6666.                            Set Sort Keys Window
  6667.                            --------------------
  6668.  
  6669. The Set Sort Keys window will be displayed over the entire screen below
  6670. the top title line when either the "Set Sort Key..." menu item from the
  6671. Folders menu is selected or the [Sort Keys] button is clicked in the
  6672. Folder Configuration window.
  6673.  
  6674. The Set Sort Keys window looks like the following:
  6675.  
  6676. =====================================================================
  6677.  
  6678.                1       2       3       4       5       6       7
  6679. Priorities: ------- ------- ------- ------- ------- ------- -------
  6680.  
  6681. Un-Read Messages: FIRST [ ]      Messages with Attachments: FIRST [ ]
  6682. Priority [@|0|     LAST [ ]      Priority [@|0|              LAST [ ]
  6683.  
  6684. Replied Messages: FIRST [ ]      Forwarded Messages: FIRST [ ]
  6685. Priority [@|0|     LAST [ ]      Priority [@|0|       LAST [ ]
  6686.  
  6687. Latest Date:      FIRST [ ]      Largest Messages: FIRST [ ]
  6688. Priority [@|0|     LAST [ ]      Priority [@|0|     LAST [ ]
  6689.  
  6690. Group by FROM at Priority [@|0|    Group by Subject at Priority [@|0|
  6691.  
  6692. [ ] Order Received
  6693.                    --> at Priority [@|0|     [ ] Apply to all Folders
  6694. [ ] Latest Received
  6695.  
  6696. [LAST SAVED]    [LAST USED]    [   USE   ]    [  SAVE  ]   [ CANCEL ]
  6697.  
  6698. =====================================================================
  6699.  
  6700. Messages in each of the folders can be displayed in various sort orders
  6701. and each folder can have a different sort order.  Up to seven levels of
  6702. sort priority can be given.  The various sorting criteria are shown on
  6703. this window and a particular sort order can be given for any sort
  6704. priority.  The sorting criteria for any particular priority is selected by
  6705. the priority cycle gadget under or opposite each criteria.  A priority of
  6706. 0 is used to indicate that this criteria is not used in the sort.
  6707.  
  6708. To help visualize which criteria applies to which priority a list at the
  6709. top of the window shows the current position of any particular sort
  6710. criteria in the priority list.  With the exception of priority 0 (no
  6711. priority), no two criteria can have the same priority.  If this happens,
  6712. **DUP** will appear for that priority in the priority list.
  6713.  
  6714. If you want the sorting criteria to be used for all folders check the
  6715. "Apply to all Folders" box.
  6716.  
  6717. At the bottom of the window is the [LAST SAVED], [LAST USED], [USE],
  6718. [SAVE], and [CANCEL] buttons.  If you want the sorting to apply only to
  6719. this AEMail session only select [USE].  If you want to make the sorting
  6720. permanent, select [SAVE].  [CANCEL], of course, will abort the operation
  6721. without setting any sort keys.  The [LAST SAVED] button is used to restore
  6722. the sort keys to those last saved and the [LAST USED] is used to restore
  6723. the last used sort keys.
  6724.  
  6725. If the this window was called from the Folder Configuration Window,
  6726. selecting [USE], [SAVE], or [CANCEL] will return you to the Folder
  6727. Configuration Window.
  6728.  
  6729. The [LAST SAVED] and [LAST USED] buttons will simply restore the
  6730. appropriate sorting order and will not terminate the Folder Configuration
  6731. Window.  You will have to use the [USE], [SAVE], or [CANCEL] buttons to do
  6732. that.
  6733.  
  6734.                       Examples of Setting Sort Keys
  6735.                       =============================
  6736.  
  6737. You may want your messages displayed in different orders in the Message
  6738. List Window.  This is the purpose of the "Set Sort Keys Window."
  6739.  
  6740. Let's assume that you want your messages displayed with unread messages
  6741. first.  Within both the unread and previously read sections you want the
  6742. messages sorted by the latest date first.  To do this click on the Un-Read
  6743. Messages:  FIRST box and set the priority underneath Un-Read Messages to
  6744. 1.  Then click on the Latest Date:  FIRST box and set it's Priority to 2.
  6745. Notice that as you change the Priority cycle gadget for Latest Date from 0
  6746. to 1 to 2, you will see *DUP* appear in priority 1 as the Date moves
  6747. through the priority 1 position.
  6748.  
  6749. The final sort window for the above sorting priority will look like this:
  6750.  
  6751. =====================================================================
  6752.  
  6753.                1       2       3       4       5       6       7
  6754. Priorities:  UNREAD   DATE  ------- ------- ------- ------- -------
  6755.  
  6756. Un-Read Messages: FIRST [X]      Messages with Attachments: FIRST [ ]
  6757. Priority [@|1|     LAST [ ]      Priority [@|0|              LAST [ ]
  6758.  
  6759. Replied Messages: FIRST [ ]      Forwarded Messages: FIRST [ ]
  6760. Priority [@|0|     LAST [ ]      Priority [@|0|       LAST [ ]
  6761.  
  6762. Latest Date:      FIRST [X]      Largest Messages: FIRST [ ]
  6763. Priority [@|2|     LAST [ ]      Priority [@|0|     LAST [ ]
  6764.  
  6765. Group by FROM at Priority [@|0|    Group by Subject at Priority [@|0|
  6766.  
  6767. [ ] Order Received
  6768.                    --> at Priority [@|0|     [ ] Apply to all Folders
  6769. [ ] Latest Received
  6770.  
  6771. [LAST SAVED]    [LAST USED]    [   USE   ]    [  SAVE  ]   [ CANCEL ]
  6772.  
  6773. =====================================================================
  6774.  
  6775. When you are satisfied with the order click on [SAVE] to save this order
  6776. for this folder only.  If you want to use this order for all your folders
  6777. click on "Apply to all Folders" before clicking on [SAVE].
  6778.  
  6779.  
  6780. Another example might have the messages displayed with unread messages
  6781. first, followed by messages grouped by SUBJECT, and within the SUBJECT
  6782. grouping, by the latest date received.  This, in effect, creates a message
  6783. threading condition with like subjects grouped together.
  6784.  
  6785. To create this sort condition, click on the Un-Read Messages:  FIRST box
  6786. and set it's priority to 1.  Then set the "Group by Subject at Priority"
  6787. cycle gadget to 2.  Finally click on the Latest Date:  FIRST box and set
  6788. it's priority to 3.  The final sort window for this grouping would be:
  6789.  
  6790. =====================================================================
  6791.  
  6792.                1       2       3       4       5       6       7
  6793. Priorities:  UNREAD SUBJECT   DATE  ------- ------- ------- -------
  6794.  
  6795. Un-Read Messages: FIRST [X]      Messages with Attachments: FIRST [ ]
  6796. Priority [@|1|     LAST [ ]      Priority [@|0|              LAST [ ]
  6797.  
  6798. Replied Messages: FIRST [ ]      Forwarded Messages: FIRST [ ]
  6799. Priority [@|0|     LAST [ ]      Priority [@|0|       LAST [ ]
  6800.  
  6801. Latest Date:      FIRST [X]      Largest Messages: FIRST [ ]
  6802. Priority [@|3|     LAST [ ]      Priority [@|0|     LAST [ ]
  6803.  
  6804. Group by FROM at Priority [@|0|    Group by Subject at Priority [@|2|
  6805.  
  6806. [ ] Order Received
  6807.                    --> at Priority [@|0|     [ ] Apply to all Folders
  6808. [ ] Latest Received
  6809.  
  6810. [LAST SAVED]    [LAST USED]    [   USE   ]    [  SAVE  ]   [ CANCEL ]
  6811.  
  6812. =====================================================================
  6813.  
  6814. If you want the messages sorted with the earlier messages first within the
  6815. subject grouping, you would click on Latest Date:  LAST rather than Latest
  6816. Date:  FIRST.
  6817.  
  6818. Since the date sort is controlled by the local date and time that the
  6819. message was SENT, you might want to use the Order Received or Latest
  6820. Received instead of Latest Date.  Order Received will list the messages
  6821. with the oldest received first, while Latest Received will list the
  6822. messages with the newest received first.
  6823.  
  6824. You, of course, can set different sort orders for different folders.  In
  6825. this case select the folder you want to change the sort order on and DON'T
  6826. click on the "Apply to all Folders" checkmark gadget.
  6827.  
  6828.  
  6829.                            Address Book Window
  6830.                            -------------------
  6831.  
  6832. The Address Book window will be displayed in the lower portion of the
  6833. screen whenever you double click on the ADDRESS BOOK command icon or on
  6834. the [Call Address Book] button in the COMPOSE MESSAGE window (see below
  6835. under the COMPOSE MESSAGE window description).
  6836.  
  6837. If you have a non-interlaced screen (640 x 200), the display will cover
  6838. the folder strip to allow more room for the Address Book display.  With an
  6839. interlaced screen (640 x 400) you will be able to see the folder strip.
  6840.  
  6841. The Address Book window looks like the following:
  6842.  
  6843. =====================================================================
  6844. Address Book
  6845. =====================================================================
  6846.  
  6847. Nick Name: [        ] Address: [                   ] Select [@| To: |
  6848.  
  6849. Real Name: [                        ] Group [ ]  Send Header Only [ ]
  6850.  
  6851. Nickname Real Name               UserID (Address)          [x] Expand
  6852. ---------------------------------------------------------------------
  6853. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  6854. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx DISTRIBUTION LIST WITH n ENTRIES | |
  6855.                                  xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  6856.                                  xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  6857. ---------------------------------------------------------------------
  6858.  
  6859.   [ ADD ]     [MODIFY]      [DELETE]      [SELECT]      [ EXIT ]
  6860.  
  6861. =====================================================================
  6862.  
  6863. This window can be used to create, modify, or delete Address Book entries.
  6864. It can also be used to select a Nickname to be used as a recipient of a
  6865. message when composing messages.
  6866.  
  6867. Several of the Command icons remain active when you are displaying the
  6868. Address Book window, although there meaning maybe slightly changed.  These
  6869. are the DISPLAY NEXT MESSAGE icon, the DISPLAY PREVIOUS MESSAGE icon, the
  6870. DISPLAY NEXT FOLDER icon, the DISPLAY PREVIOUS FOLDER icon, the DISPLAY
  6871. CURRENT FOLDER icon, the PRINT icon, the DELETE icon, and the COMPOSE
  6872. MESSAGE icon.
  6873.  
  6874. The three fields of an address book entry are:  a one to eight character
  6875. Nickname, an individual's real name (up to 99 characters), and the address
  6876. of the individual (UserId and Domain in the form userid@domain) which is
  6877. limited to 70 characters.
  6878.  
  6879. Group lists can also be created which distributes a message to a number of
  6880. different individuals.  The group is identified with the heading
  6881. "DISTRIBUTION LIST WITH nnn ENTRIES" in the top most UserID field.  The
  6882. nnn indicates the number of entries in the group.  The UserID's for the
  6883. members of that list are shown in alphabetic order below that heading.  For
  6884. items in the distribution list, real UserIDs or Nicknames can be used.  An
  6885. item in the distribution list can even be another distribution list
  6886. identified by the Nickname for that group.  By clicking on the Checkmarked
  6887. item "Group", you can identify the entry as a group item.
  6888.  
  6889. The checkmarked item identified as "Send Header Only" is only active when
  6890. "Group" is checked.  If a checkmark is in the "Send Header Only" box, only
  6891. the group name will be sent in the To:  field when a message is sent to
  6892. the group; otherwise, every UserId in the group will be listed in the To:
  6893. header.  It is a good idea to check this item if you have large groups or
  6894. if you don't want the other members of the group to know all the members
  6895. of the group.
  6896.  
  6897. If a Nickname rather than a UserID is used in the group list Address
  6898. field, then, if a modification is made to the UserID of the Nickname, you
  6899. do not have to change the item in the Group list.  The modification will
  6900. be automatic when the group rather than the individual is selected.
  6901.  
  6902. When composing a message, a Nickname can be used to identify the recipient
  6903. of a message.  All Nicknames are expanded to Real Name and UserID when
  6904. mail is sent.
  6905.  
  6906. For registered users of AEMail, the checkmarked box to the far right of
  6907. the list heading labeled "Expand" is used to shrink or expand the group
  6908. entries in the list.  When this box is not checked, only the group heading
  6909. is displayed without the entries in the group showing.  When it is
  6910. checked, the groups are expanded to show all the members of the group.
  6911. When first displayed, this item will be checked.  However, the system
  6912. remembers the state of this checkmark so if you should shrink the groups,
  6913. the next time you select the Address Book only the group headings will be
  6914. displayed.
  6915.  
  6916. For un-registered users, this item will be checked and ghosted.  You will
  6917. not be able to shrink the groups.
  6918.  
  6919. Address Book entries are sorted by Nickname and group entries are
  6920. interspersed with single entries.  Also Real Names are presented as first
  6921. name followed by last name rather than last name, first name.
  6922.  
  6923. This is a scrolling list.  If there are too many entries to fit in the
  6924. window, you can scroll the list by using the scroll bar, clicking on the
  6925. up or down arrows below the scroll bar, or by using the up or down cursor
  6926. keys.
  6927.  
  6928. Additionally the following keys can be used to move the list as follows:
  6929.  
  6930.     "Home" or "ALT Cursor Up" moves the listview to the top.
  6931.     "End" or "ALT Cursor Down" moves the listview to the botton.
  6932.     "PgUp" or "Shift Cursor Up" pages the listview one "page" up.  The
  6933.         top line of the previous page will be displayed as the bottom
  6934.         line of the new page.
  6935.     "PgDn" or "Shift Cursor Down" pages the list view one "page" down.
  6936.         The bottom line of the previous page will be displayed as the
  6937.         top line of the new page.
  6938.     The cursor up/down keys on the keypad will have the same action as
  6939.         the normal cursor keys with the exception of the shift
  6940.         feature.
  6941.  
  6942. WARNING:  if you have selected one of the string gadgets for entering
  6943. data, the keys listed above will not work for scrolling the list.  You
  6944. will have to click outside of the string gadget to re-activate scrolling
  6945. with the cursor keys.
  6946.  
  6947. For adding entries to the Address Book, the entries at the top of the
  6948. window are used to place data in the various fields of the Address Book
  6949. entry.  If a message was selected when the address book was called, the
  6950. Real Name:, if present, and Address:  fields are filled in with
  6951. information from the Reply-To:  header of the message.  If the Reply-To:
  6952. header is not present, the From:  header will be used.  You can force the
  6953. From:  header to be used by holding down the shift key when you click on
  6954. the Address Book icon.
  6955.  
  6956. Please keep in mind that Reply-To:  addresses normally do not have real
  6957. names associated with them, but From:  addresses many times do.  If you
  6958. want the real name you may have to hold down the shift key when you click
  6959. on the Address Book icon.
  6960.  
  6961. If you access the Address Book from the Compose message window during a
  6962. "mailto:" call to AEMail, the userid from the "mailto:" will be placed in
  6963. the address field.  This allows you to assign a Nickname and Real Name to
  6964. this address and save it in your Address Book.
  6965.  
  6966. If you click on one of the entries in the list view, that entry will be
  6967. transferred to the Nickname:, Real Name:, and Address:  fields at the top
  6968. of the window.  If you click on a group entry line which has the Group
  6969. Nickname and "DISTRIBUTION LIST ..." in the address portion, only the
  6970. Nickname:  and the Group name (in the Real Name field) will be transferred
  6971. leaving any previous address in the Address field.  The "Group" box will
  6972. also be checked.  This facilitates adding items to a Group list.
  6973.  
  6974. When adding an entry to the address book, you must always enter a Nickname
  6975. and Address.  Real Name is optional, but recommended.
  6976.  
  6977. To add a group entry, the "Group" box must be checked.  Groups need a
  6978. Nickname that is unique (not the same as that used for an individual) and
  6979. should have a group description entered in the Real Name:  string gadget.
  6980. Group entries are entered one at a time.  The maximum number of entries
  6981. that can be added to a group is 3000.  When a message is sent to a group,
  6982. the message will be sent to a maximum of 50 recipients at a time.  This
  6983. takes care of problems when there is a limit on the number of recipient
  6984. addresses that a SMTP server can handle at a time.
  6985.  
  6986. After correctly filling in the top portion of the window, click on the
  6987. [ADD] button to add the item to the list.  Except for group Nicknames,
  6988. there can't be a duplicate Nickname when adding to the list.  An already
  6989. existing group Nickname will cause the entry to be added to that groups
  6990. distribution list.
  6991.  
  6992. To modify an entry, the Nickname for the entry must already exist in the
  6993. list.  You can not modify Nicknames.  If you need to do this, delete the
  6994. old entry and add a new one.  For individual entries, you can modify
  6995. either the Real Name:  or Address:  fields.  For group entries you can
  6996. only modify the Real Name:  field.  If you need to modify an address in
  6997. the distribution list, delete the old one and add a new one.
  6998.  
  6999. One of the reasons that Nicknames are preferred in distribution lists is
  7000. that, if you need to modify a user's address, you can do so by simply
  7001. modifying the Individual's entry.  The address in the group is then
  7002. automatically updated by reference.
  7003.  
  7004. Selecting one of the entries in the address list will move the data from
  7005. that entry to the fields at the top of the window.  Make the modifications
  7006. you want then click on the [MODIFY] button to make the modifications.
  7007.  
  7008. To delete an entry, select it in the list and then click on the [DELETE]
  7009. button.  You can also use the DELETE icon to do this.
  7010.  
  7011. The [SELECT] button is used only for one special purpose.  If the full
  7012. Address Book was called from a "mailto:" call to AEMail, this button is
  7013. used to select an address from the Address Book and place it in the
  7014. appropriate recipients address line while composing the message.  The
  7015. Address Book display is slightly different if it was not a "mailto:" call
  7016. (see below).
  7017.  
  7018. When you click on the [SELECT] button, the Address Book display is closed
  7019. and the COMPOSE MESSAGE window is re-activated.  To determine which header
  7020. field is to receive the address, the "Select" cycle gadget at the top of
  7021. the window is used.  There are three items for this gadget:  To:, cc:, and
  7022. bcc:.  Determine which field should receive the address and then click on
  7023. the [SELECT] button.  The Nickname for the selected item is transferred to
  7024. the appropriate field in the compose window.
  7025.  
  7026. If the Address Book was not called from the Compose window, the "Select"
  7027. cycle gadget will be ghosted and can not be used.  If the Address Book was
  7028. called from the COMPOSE MESSAGE window, clicking on one of the address
  7029. fields before calling the Address Book will automatically select the
  7030. appropriate field in the "Select" cycle gadget.
  7031.  
  7032. You can avoid using the [SELECT] button for returning to the COMPOSE
  7033. MESSAGE Window by double clicking on an item in the Address Book list
  7034. view.
  7035.  
  7036. If the Address Book was not called from the COMPOSE MESSAGE window,
  7037. instead of double clicking, the COMPOSE MESSAGE command icon can be
  7038. selected when in the Address Book window.  When this is done, the COMPOSE
  7039. MESSAGE window is activated for composing a new message with the selected
  7040. address field always being the To: field.  The selected address in the
  7041. Address Book will be moved to the To: field.
  7042.  
  7043. The [EXIT] button is used to exit from the Address Book window without
  7044. performing any address selection for a composed message.  You will need to
  7045. [EXIT] from the Address Book if you want to quit AEMail.
  7046.  
  7047. If the Address Book was called while displaying a message, clicking on the
  7048. DISPLAY NEXT MESSAGE or the DISPLAY PREVIOUS MESSAGE icons will
  7049. automatically exit from the Address Book and display either the next or
  7050. previous message in the currently displayed message list.
  7051.  
  7052. If you click on the DISPLAY NEXT FOLDER, the DISPLAY PREVIOUS FOLDER, or
  7053. DISPLAY CURRENT FOLDER icons, the Address Book will be closed and the
  7054. appropriate message list for the selected folder will be displayed.
  7055.  
  7056. If the PRINT icon is selected while you are displaying the Address Book,
  7057. you will get a printout of your complete address book.  All individual
  7058. entries will be displayed first followed by group entries.  Unless a group
  7059. is too large to fit on one page, an attempt will be made to ensure that a
  7060. group will be printed in it's entirety on a page.
  7061.  
  7062. When the Address Book is be called from the COMPOSE MESSAGE window and the
  7063. COMPOSE MESSAGE window was not activated during a "mailto:" call to
  7064. AEMail, the Address Book display will be slightly different.  It will look
  7065. like this:
  7066.  
  7067. =====================================================================
  7068. |+| Address Book For Compose
  7069. =====================================================================
  7070.  
  7071. Nickname Real Name               UserID (Address)          [ ] Expand
  7072. ---------------------------------------------------------------------
  7073. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  7074. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx DISTRIBUTION LIST WITH n ENTRIES | |
  7075. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx DISTRIBUTION LIST WITH n ENTRIES | |
  7076. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  7077. ---------------------------------------------------------------------
  7078.  
  7079. Click on Address Book entry to transfer to [@| To: | field  [ CLOSE ]
  7080.  
  7081. =====================================================================
  7082.  
  7083. This is an abreviated window which does not have the string gadgets for
  7084. creating or deleting Address Book entries.  It is designed for selecting
  7085. addresses to transfer to the COMPOSE MESSAGE window only.  When you click
  7086. on an address in the window it will be transferred to the appropriate
  7087. field in the COMPOSE MESSAGE window as determined by the cycle gadget at
  7088. the bottom of the window.  There are three items for this gadget:  To:,
  7089. cc:, and bcc:  (the same as the "Select" cycle gadget in the full Address
  7090. Book window.  Select which field should receive the address and click on
  7091. the address in the Address Book.  You can select multiple addresses; the
  7092. window will not close until you click on either the Close gadget at the
  7093. top of the Address Book window or the [CLOSE] button at the bottom of the
  7094. window.  The Address Book window will also close if you double click on a
  7095. name (It will be transferred and then the window will close).
  7096.  
  7097. You can also select which field you want to receive the address by
  7098. clicking into the appropriate field in the COMPOSE MESSAGE window.  You
  7099. will see the cycle gadget switch to that field and the cursor will
  7100. disappear from the field since the Address Book window will again become
  7101. activated.
  7102.  
  7103. When the Address Book is called from the COMPOSE MESSAGE window it will be
  7104. in the un-expanded state.  If you are a registered user, you can expand
  7105. the group names by clicking on the "Expand" checkmark gadget to the right
  7106. of the listview headings.
  7107.  
  7108. You can also have the full Address Book display called from the COMPOSE
  7109. MESSAGE window by holding down the shift key when you click on the [Call
  7110. Address Book] gadget.
  7111.  
  7112. NOTE:  When AEMail is loaded it will automatically create an address book
  7113. entry for the Nickname AEMail with an address for my email address:
  7114. jzachar@calweb.com.  You can use this entry whenever you wish to report a
  7115. bug or send a message concerning AEMail to me.
  7116.  
  7117.  
  7118.                           Message Display Window
  7119.                           ----------------------
  7120.  
  7121. The Message Display window will be displayed in the lower portion of the
  7122. screen whenever you double click on a message in the message list window.
  7123. If you are already displaying a message, clicking on the NEXT or PREVIOUS
  7124. command icons will display either the NEXT or PREVIOUS message.
  7125.  
  7126. If you have a non-interlaced screen (640 x 200), the display will cover
  7127. the folder strip to allow more room for the message display.  With an
  7128. interlaced screen (640 x 400) you will be able to see and use the folder
  7129. strip.
  7130.  
  7131. To re-display the Message List, click on the "folder" icon on the Command
  7132. Icon Tool Bar or one of the folders in the folder icon bar (if visable).
  7133.  
  7134. The message is divided into two sections:  message header information,
  7135. which is always present, and a scrolling list that displays the message.
  7136. Header information will also be displayed in the scrolling message
  7137. listview, but only those header lines that you want displayed.
  7138.  
  7139. The message header portion of the screen is set up as follows:
  7140.  
  7141. From: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Date: DOW, MMM DD YYYY HH:MM:SS
  7142. To: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx [ATTACHMENT]
  7143. Subject: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  Active Msg
  7144.  
  7145.  
  7146. The From:  and To:  fields will show the Real Name (if present) from the
  7147. appropriate header.  If the Real Name is not present in the header, then
  7148. the UserID will be used instead.  If a Nickname is being used for a
  7149. message being sent, then the Nickname will appear.
  7150.  
  7151. The Subject field will have the RE; or (FWD) preappended to the field for
  7152. messages that are REPLIES and/or are FORWARDED.
  7153.  
  7154. If the message has attachments, either MIME or UUENCODED, the [ATTACHMENT]
  7155. button will appear at the right of the To:  line.  If no attachments are
  7156. present this button will say [SAVE TEXT] instead.  Clicking on the [SAVE
  7157. TEXT] button will bring up the save text requester along side the [SAVE
  7158. TEXT] button which is described below under "Save Text Requester".
  7159.  
  7160. For messages that are active (not deleted), "Active Msg" will appear in a
  7161. text box to the right of the Subject line.  If the message is a deleted
  7162. message "Deleted Msg" will appear in red in place of "Active Msg".
  7163.  
  7164. The complete message will be displayed in the message listview including
  7165. any text type attachments.  If the attachments are UUENCODED attachments
  7166. or are non-text type attachments, they will not be shown, but can be
  7167. retrieved by clicking on the [ATTACHMENT] button.  This will bring up an
  7168. attachment requestor which is described below under "Attachment
  7169. Requester".
  7170.  
  7171. Messages that are encoded with "Quoted-Printable" notation as well as text
  7172. messages encoded with encoded binary (BASE64) will be correctly displayed
  7173. as well.  Since these types of messages will be saved with their encoding
  7174. intact when saved using the SAVE MESSAGE icon or the "Export..." item
  7175. under the Messages menu, the [SAVE TEXT] gadget has been provided to save
  7176. message text correctly decoded for messages without attachments.  For
  7177. messages with attachments, the first entry in the Attachment list is the
  7178. body of messages itself.
  7179.  
  7180. The message display is a scrolling list.  There are four methods that you
  7181. can use to scroll the message:
  7182.  
  7183.     (1) Use the scroll bar to the right of the message.
  7184.  
  7185.     (2) Use the scroll arrows at the bottom of the scroll bar.
  7186.  
  7187.     (3) Use the up and down cursor keys.  You can also move the listview
  7188.         with other keys as follows:
  7189.  
  7190.         "Home" or "ALT Cursor Up" moves the listview to the top.
  7191.         "End" or "ALT Cursor Down" moves the listview to the botton.
  7192.         "PgUp" or "Shift Cursor Up" pages the listview one "page" up.  The
  7193.             top line of the previous page will be displayed as the bottom
  7194.             line of the new page.
  7195.         "PgDn" or "Shift Cursor Down" pages the list view one "page" down.
  7196.             The bottom line of the previous page will be displayed as the
  7197.             top line of the new page.
  7198.         The cursor up/down keys on the keypad will have the same action as
  7199.             the normal cursor keys with the exception of the shift
  7200.             feature.
  7201.  
  7202.     (4) click the mouse on the list display and while holding down
  7203.         the left mouse button, move above or below the display.
  7204.         When you lift up on the mouse button after the list
  7205.         starts to scroll, you can continue to scroll by moving
  7206.         the mouse up or down.  Clicking into the display will
  7207.         stop the scrolling action.
  7208.  
  7209. While messages are loaded into the listview, you will not see them until
  7210. they are completely read.  A busy pointer will be displayed until the
  7211. listview is completely built.
  7212.  
  7213. You can change the font for the message display.  If you want a larger
  7214. font for displaying message text, go to the Fonts Page of the
  7215. Configuration Setup (activated by the Configuration/Edit menu item under
  7216. the Project menu) and change the font in the "Message Font" section.  Any
  7217. font or font size can be used, but selecting a proportional font for some
  7218. messages may take longer for the message to load.  If you are an
  7219. un-registered user you will be able to change the font for the current
  7220. session of AEMail but you will not be able to save the font selection for
  7221. subsequent AEMail sessions.
  7222.  
  7223. You can also edit and save lines from the message to the clipboard by
  7224. double clicking on any line in the message.  This will open a window at
  7225. the top of the screen for editing and saving the line to the clipboard.
  7226. See the section "Using the Clipboard with AEMail" under V. USING AEMAIL.
  7227.  
  7228. If the line you double click on contains an email address (determined by
  7229. the @ between adjoining strings) or a web address (deterined by www.
  7230. within the string), just the email address or the web address will be
  7231. transferred to the string.  If the web address does not have http:// at
  7232. the beginning of the string, that will be added.
  7233.  
  7234. If you hold down the shift key when you double click on such an address,
  7235. the entire line will be trasferred, not just the email or web address.
  7236.  
  7237. If you have transferred an email or web address you can also hit a
  7238. function key to execute an ARexx script.  The email address or web address
  7239. will be transferred to a special variable and the script will be executed.
  7240. If the script contains the ARexx command GETVAR it will receive the
  7241. variable string in the RESULT variable and can act on it.  Several sample
  7242. ARexx scripts have been placed in your ARexx directory which can extract
  7243. the address from the special variable and call your web browser to go to
  7244. that web page (gotowww.aem), send a message to the email address
  7245. (sendmsg.aem) or place the email address in the address book either as an
  7246. individual address (placeaddr.aem) or as a group address (placegrp.aem).
  7247.  
  7248.                            Save Text Requester
  7249.                            ===================
  7250.  
  7251. When you click on the [SAVE TEXT] button on the Message Display Window, a
  7252. a tiered set of five buttons will appear to the left of the [SAVE TEXT]
  7253. gadget that look like this:
  7254.  
  7255.                          [    VIEW   ]
  7256.                          [ SAVE FILE ]
  7257.                          [ SAVE CLIP ][SAVE TEXT]
  7258.                          [ CLIP UNIT ]
  7259.                          [   CANCEL  ]
  7260.  
  7261.  
  7262. Clicking on one of the buttons will perform the appropriate action as
  7263. described below.  With the exception of [CLIP UNIT], the buttons will
  7264. disappear at the completion of the action.
  7265.  
  7266.     [VIEW]
  7267.  
  7268.         This will display the message text with the program you selected
  7269.         in the "mailcap" file for the "text" MIME type.  If a program was
  7270.         not pre-defined for this MIME type, this button will be disabled
  7271.         (ghosted).  This option is given so that you can select special
  7272.         message display programs to display the message and perhaps
  7273.         perform special operations of the message.  As an example, you
  7274.         could specify an editor which would allow you to make
  7275.         modifications to the message and then save portions of it to a
  7276.         file or clipboard.
  7277.  
  7278.     [SAVE FILE]
  7279.  
  7280.         A  file requester will pop up which allows you to select 
  7281.         a file to save your message to.  If the message used a coding
  7282.         scheme such as quoted-printable or encoded binary it will be
  7283.         properly converted before it is saved.  The default directory
  7284.         designated to receive this text file is RAM:; however, you can
  7285.         change this with the file requester or set a different
  7286.         default with the Default Path Parameters display on the
  7287.         Configuration Setup Window.
  7288.  
  7289.     [SAVE CLIP]
  7290.  
  7291.         If the text has an encoding type of 7-bit, 8-bit, or
  7292.         quoted-printable, you can save it to the current clipboard unit.
  7293.         If the text is encoded binary, this button will be ghosted.
  7294.  
  7295.     [CLIP UNIT]
  7296.  
  7297.         This will bring up the requester that allows you to change the
  7298.         current clipboard unit (see "Using the Clipboard with AEMail"
  7299.         under V. USING AEMAIL).
  7300.  
  7301.     [CANCEL]
  7302.  
  7303.         This gadget is provided to exit from the request without
  7304.         performing any action.
  7305.  
  7306.                            Attachment Requester
  7307.                            ====================
  7308.  
  7309. When you click on the [ATTACHMENTS] button on the Message Display Window,
  7310. an Attachment Requester will be displayed.  It looks like this:
  7311.  
  7312.       |============================================================|
  7313.       |o|  Attachment List                                         |
  7314.       |============================================================|
  7315.       |                MimeType/SubType          File Name         |
  7316.       | ========================================================== |
  7317.       | | 1  SHOWN     text/plain                              | | |
  7318.       | |    Description: (None)                               | | |
  7319.       | | 2  VIEWABLE  image/gif                 castle.gif    | | |
  7320.       | |    Description: Picture of a castle                  | | |
  7321.       | | 3  SAVE ONLY application/octet-stream  aemail.lha    | | |
  7322.       | |    Description: The AEMail archive                   | | |
  7323.       | ========================================================== |
  7324.       |                                                            |
  7325.       |   [    VIEW   ]       [VIEW & SAVE]        [ SAVE FILE ]   |
  7326.       |                                                            |
  7327.       |   [ SAVE CLIP ]       [ CLIP UNIT ]        [    EXIT   ]   |
  7328.       |____________________________________________________________|
  7329.  
  7330. This requester is initially placed at the top center of the window
  7331. partially obscuring the command and folder icons and the top portion of
  7332. the message.  You can drag the requester around the window to expose other
  7333. items of the display.  You can also use the scroll bar on the message
  7334. display listview to show different parts of the message; however, none of
  7335. the commands on the command or folder bar or the menu bar can be activated
  7336. until after you click on the [EXIT] button in the Attachment Requester.
  7337.  
  7338. The SHOWN designation is used for any attachment that is displayed in the
  7339. message window.  This is generally any attachment that has a MIME type of
  7340. text or message.  However, standard Mailcap entries have been included in
  7341. the Mailcap file to also display and save these attachments from the
  7342. Attachment window.
  7343.  
  7344. Any message with attachments will generally have one section (the initial
  7345. message) which is displayable text and will be shown as an attachment with
  7346. the SHOWN designation.  You will also be able to VIEW all SHOWN parts of
  7347. the message separably.  You will always be able to save any item in the
  7348. list in it's un-encoded form.
  7349.  
  7350. UUENCODED attachments will have the designation UUENCODED displayed in the
  7351. MIME types/subtypes field.
  7352.  
  7353. Any attachments that do not have a MIME type of text or message will have
  7354. either a VIEWABLE or SAVE ONLY designation.  The VIEWABLE designation is
  7355. used for those MIME types/subtypes which have a program designated in the
  7356. mailcap file for displaying this MIME type/subtype.  If no program is
  7357. designated for this MIME type/subtype the SAVE ONLY designator will appear
  7358. on the attachment line and the [VIEW] and the [VIEW & SAVE] buttons will
  7359. be disabled.
  7360.  
  7361. UUENCODED attachments are always SAVE ONLY attachments.
  7362.  
  7363. To select an attachment to view, view & save, or to save only, select the
  7364. appropriate attachment line in the list view gadget.  You can select the
  7365. main description line (with number, mime type, and filename) or the second
  7366. line with the "Description:" heading.
  7367.  
  7368. After selecting the attachment, the buttons below the listview will
  7369. perform the following actions:
  7370.  
  7371.     [VIEW]
  7372.  
  7373.         This will display the attachment with the program you
  7374.         selected in the "mailcap" file for this MIME type/subtype.
  7375.         If a program was not pre-defined for this MIME type/subtype
  7376.         this button will be disabled and you will not be able to
  7377.         display the attachment.  You will also see SAVE ONLY rather
  7378.         than VIEWABLE on the description of this attachment.
  7379.  
  7380.     [VIEW & SAVE]
  7381.  
  7382.         A file requester will pop up which allows you to select
  7383.         a file to save your attachment to.  The default directory
  7384.         designated to receive attachments is RAM:; however, you can
  7385.         change this with the file requester or set a different
  7386.         default with the Default Path Parameters page on the
  7387.         Configuration Setup Window.
  7388.  
  7389.         If a file name was provided in either the Content-Type: or
  7390.         Content-Disposition: headers, the file name will be shown
  7391.         on the attachment description and will be pre-set as the
  7392.         filename in the file requester.  You can, of course, change
  7393.         this name if you wish.
  7394.  
  7395.         After the file is saved, the attachment will be displayed
  7396.         with the program you selected in the "mailcap" file.
  7397.  
  7398.         If a program was not pre-defined for this MIME type/subtype
  7399.         this button will be disabled and you will not be able to
  7400.         display the attachment.  You will also see SAVE ONLY rather
  7401.         than VIEWABLE on the description of this attachment.
  7402.  
  7403.  
  7404.     [SAVE FILE]
  7405.  
  7406.         A file requester will pop up which allows you to select
  7407.         a file to save your attachment to.  The default directory
  7408.         designated to receive attachments is RAM:; however, you can
  7409.         change this with the file requester or set a different
  7410.         default with the Default Path Parameters display on the
  7411.         Configuration Setup Window.
  7412.  
  7413.         If a file name was provided in either the Content-Type: or
  7414.         Content-Disposition: headers or with the UUENCODED "begin"
  7415.         line, the file name will be shown on the attachment
  7416.         description and will be pre-set as the default filename
  7417.         in the file requester.  You can, of course, change this
  7418.         name if you wish.
  7419.  
  7420.         You will always be able to save any attachment even if it
  7421.         is SHOWN and a filename is not specified.
  7422.  
  7423.     [SAVE CLIP]
  7424.  
  7425.         If the attachment has an encoding type of 7-bit, 8-bit, or
  7426.         quoted-printable, you can save the attachment to the current
  7427.         clipboard unit.  If the attachment is not a text type attachment
  7428.         (encoded binary), this button will be ghosted.
  7429.  
  7430.     [CLIP UNIT]
  7431.  
  7432.         This will bring up the requester that allows you to change the
  7433.         current clipboard unit (see "Using the Clipboard with AEMail"
  7434.         under V. USING AEMAIL).
  7435.  
  7436.     [EXIT]
  7437.  
  7438.         After performing all the operations you wish for any
  7439.         particular attachment, click on this button to remove
  7440.         the Attachment Requester.  This requester also has a
  7441.         CLOSE gadget which you can also use to exit from the
  7442.         requester.
  7443.  
  7444.  
  7445.                           Compose Message Window
  7446.                           ----------------------
  7447.  
  7448. The Compose Message window is brought up whenever you click on the COMPOSE
  7449. MESSAGE command icon or select the Compose..., Reply..., or Forward...
  7450. sub-menus under the Messages menu.  If a message is selected when you
  7451. click on the COMPOSE MESSAGE command icon it will act as a "Reply to this
  7452. message" action.
  7453.  
  7454. The Compose Message window will cover the entire screen.  You must proceed
  7455. sequentional through the actions or cancel to abort the compose operation.
  7456.  
  7457. The Compose Message window looks like this:
  7458.  
  7459. =====================================================================
  7460. Compose a Message (Signature: [full path of signature file active])
  7461. =====================================================================
  7462.  
  7463.        To: [                              ][CLR] [Call Address Book ]
  7464.  
  7465.        cc: [                                                   ][CLR]
  7466.  
  7467.       bcc: [                                                   ][CLR]
  7468.  
  7469.  Reply To: [                                   ][CLR] [ Use Default ]
  7470.  
  7471.   Subject: [                                                   ][CLR]
  7472.  
  7473.            [] New Message                    [] 7-Bit
  7474.            [] Reply to Message               [] 8-bit
  7475.            [] Forward Message                [] quoted-printable
  7476.                                              [] encoded binary
  7477.  
  7478.  [ ] Quote Original Message Text   Quote Prefix[>                    ]
  7479.  
  7480.    Quote Header: [                                                   ]
  7481.  
  7482.  [ ] Add Signature Block   [Select Signature]        [ Edit Signature]
  7483.  
  7484.  [Compose/Edit Message]    [  Add Headers   ]        [Add Attachments]
  7485.  
  7486.  [Send Message Now] [Queue Message] [Save In Pending] [Cancel Message]
  7487.  
  7488. ======================================================================
  7489.  
  7490. The title bar on the Compose Message window will contain the full path
  7491. name to the current, in use signature file.
  7492.  
  7493. When the Compose Message window first appears and if the message is a
  7494. replied message, the following requester will appear if the replied
  7495. message had To:  recipients other than yourself:
  7496.  
  7497.  
  7498.        |=========================================================|
  7499.        | Multiple Recipients                                     |
  7500.        |---------------------------------------------------------|
  7501.        |             The message you are replying to             |
  7502.        |                has other To: recipients.                |
  7503.        |              Do you want to send the reply              |
  7504.        |                                                         |
  7505.        | [o] to only the sender of the original message?         |
  7506.        | [ ] to all To: recipients of the original message?      |
  7507.        | [ ] cc: to all To: recipients of the original message?  |
  7508.        | [ ] bcc: to all To: recipients of the original message? |
  7509.        |                                                         |
  7510.        |                       [ Continue ]                      |
  7511.        |                                                         |
  7512.        |=========================================================|
  7513.  
  7514. With this requester you can send the message you are composing to none of
  7515. the other recipients, directly to all the other recipients (in the To:
  7516. line), as a cc to all the recipients, or as a bcc to all the other
  7517. recipients.
  7518.  
  7519. If there is a single recipient to the message and that recipient is the
  7520. same as either your From:  or Reply-To:  address, you will not see the
  7521. requester.  Also, when the list of recipients is transferred to the
  7522. appropriate address line in the Compose window, any address that is the
  7523. same as your From:  or Reply-To:  address will be stripped.  If you want
  7524. to send the message also to the From:  or Reply-To: address you will have
  7525. to add the address yourself.
  7526.  
  7527. When you have selected the action you want, hit [Continue] and the list of
  7528. To: recipients will be transferred to the appropriate string gadget in
  7529. the Compose Message window.
  7530.  
  7531. SPECIAL CONSIDERATION:  If the message you are replying to was received by
  7532. a version of AEMail prior to 1.42, you will not be able to transfer
  7533. recipients that extend beyond one line.  You can solve this problem,
  7534. however, by saving the message you want to reply to to a file (using the
  7535. export function) and then reading it back into version 1.43 of AEMail.
  7536. To read it back in using the "From Local File.." menu item under the
  7537. "Retrieve Msgs" menu.
  7538.  
  7539. One point of warning.  If the recipient of the original message was the
  7540. name of a list rather than the name of an individual, you will also see
  7541. this requester.  Unfortunately, there is no way to know that the recipient
  7542. name is a list name rather than an individual name.  In this event, you
  7543. should always select "to only the sender of the original message" since
  7544. the list name is probably not a valid recipient.
  7545.  
  7546. If there were cc:'s to the original message, you may also see the
  7547. following similar requester for sending to the cc: recipients:
  7548.  
  7549.        |=========================================================|
  7550.        | Multiple Recipients                                     |
  7551.        |---------------------------------------------------------|
  7552.        |             The message you are replying to             |
  7553.        |             has one or more cc: recipients.             |
  7554.        |              Do you want to send the reply              |
  7555.        |                                                         |
  7556.        | [o] to only the sender of the original message?         |
  7557.        | [ ] to all cc: recipients of the original message?      |
  7558.        | [ ] cc: to all cc: recipients of the original message?  |
  7559.        | [ ] bcc: to all cc: recipients of the original message? |
  7560.        |                                                         |
  7561.        |                       [ Continue ]                      |
  7562.        |                                                         |
  7563.        |=========================================================|
  7564.  
  7565. Again, after you have selected the action you want, hit [Continue] and the
  7566. list of cc: recipients will be transferred to the appropriate string gadget
  7567. in the Compose Message window.
  7568.  
  7569. If the message is a replied message, the To: string gadget will also be
  7570. filled in with the Reply-To: address from the message you are replying to
  7571. or, if that is not present, the From: real name and user ID of the
  7572. message you are replying to.  This is in addition to any action caused by
  7573. the previously mentioned requesters.
  7574.  
  7575. You can force the From: address to be used by holding down the shift key
  7576. when clicking on the "compose" icon or selecting the menu sub-item "Use
  7577. From..." on the Reply menu item of the Messages menu.
  7578.  
  7579. Also, if the message is the result of a "mailto:" call, the To:  string
  7580. gadget will be filled in with the userid passed by the "mailto:" call.
  7581.  
  7582. If the message is a replied or forwarded message, the Subject:  string
  7583. gadget will be automatically filled in with the subject from the replied
  7584. or forwarded message.  RE:  or (fwd) will also automatically appear in
  7585. front of the subject.
  7586.  
  7587. You may enter names, either Nicknames or Real Names and/or UserIDs, for
  7588. any of the To:, cc:, or bcc:  fields.  If a Real Name and/or UserID is
  7589. entered, it should be entered as
  7590.  
  7591.         Real Name<userid@domain>              or
  7592.         userid@domain(Real Name)              or
  7593.         userid@domain
  7594.  
  7595. The domain can be left off if the recipient is at the same domain as the
  7596. user.  However, it is best that the full userid@domain be used so there is
  7597. no confusion with Nicknames.
  7598.  
  7599. If a Nickname is used it will be automatically expanded when the message
  7600. is sent.
  7601.  
  7602. If multiple users are placed in any of the To:, cc:, or bcc: fields they
  7603. must be separated by commas.  Each of the string gadgets (To:, cc:, or
  7604. bcc:) can hold a string up to 4096 charcaters long.  This allows you to
  7605. build up quite a long list of recipients; however, using a group Nickname
  7606. is preferable since only one name is needed in the string gadget.
  7607.  
  7608. If the users you are sending the message to are in your Address Book, you
  7609. can click on the [Call Address Book] button.  This will call up an
  7610. abreviated form of your Address Book (see Address Book window discussion
  7611. above) and you can select the user you want.  Clicking on the user will
  7612. transfer the Nickname for that user to the appropriate field indicated by
  7613. the cycle gadget at the bottom of the Address Book window (To:, cc:  or
  7614. bcc:).  The Nickname for the user will be automatically added to the
  7615. appropriate field in the Compose window.  If you make a mistake and the
  7616. wrong name is added or it is added to the wrong field, you can use the
  7617. backspace key to remove the offending nickname or the [CLR] gadget to
  7618. completely clear the field.
  7619.  
  7620. The Address Book window will remain displayed to allow you to select
  7621. multiple names.  Multiple names in any field will be automatically
  7622. separated by commas.
  7623.  
  7624. To exit from the Address Book display, either click on the Close gadget at
  7625. the top of the Address Book window or the [CLOSE] button at the bottom of
  7626. the window.  Alternately, you can double click on the last name you add to
  7627. a field.
  7628.  
  7629. You can also use the [Call Address Book] gadget to place the userid from a
  7630. "mailto:" call into your Address Book.  In this case the full address book
  7631. will be shown rather than the abbreviated one.  You can also access the
  7632. full Address Book by pressing the shift key when you click on the [Call
  7633. Address Book] gadget (see the discussion of the Address Book window
  7634. above).
  7635.  
  7636. All of the gadgets in the Compose Window remain active when you are
  7637. displaying the abbreviated form of the Address Book.  They are not active
  7638. when you display the full Address Book.  The "select" cycle gadget in the
  7639. Address Book can be used to select the field you want the address
  7640. transferred to, or alternately, you can click into the field you want and
  7641. the cycle gadget will automatically be set to that field.  When you do
  7642. this, the Address Book window will immediately become activated to allow
  7643. you to select the address you want or to move the Address Book list view
  7644. with the cursor keys.
  7645.  
  7646. The cc:  field is used to send a "carbon copy" of the message to the
  7647. people in the list on the cc:  line.  The cc:  header will appear on the
  7648. message sent to the To:, cc:  and bcc:  recipients.  The bcc:  field is
  7649. used the send a "blind carbon copy" to the people in that list.  The bcc:
  7650. recipients will not be identified to any of the recipients of the message.
  7651.  
  7652. The Reply To:  field is used to place a Reply-To:  address header in the
  7653. message.  This field is intended for people who want replies directed to a
  7654. different email address than their From:  address.  The configuration item
  7655. "Reply-To:" will automatically be loaded into this field when the compose
  7656. window is displayed.  If the Reply To:  address for this message should be
  7657. different than the configured Reply-To address, then place it here.  If
  7658. you click on the [ Use Default ] button, your configured Reply-To address
  7659. will be placed in this field.  If the Reply To:  field is left blank, no
  7660. Reply-To:  header line will be added to the message.
  7661.  
  7662. The Subject:  field is used to create a subject header for your message.
  7663. If the message is a reply, RE:  will be placed in front of the subject.
  7664. If the message is forwarded, (fwd) will be placed after the subject.
  7665.  
  7666. The [CLR] gadget to the right of the To:, Reply To:, Subject:, cc:, and
  7667. bcc:  string gadgets allows you to easily clear the data in the
  7668. appropriate string gadget.
  7669.  
  7670. Below the Subject field is two columns of Radio buttons for selecting the
  7671. type message to create and to specify the encoding method for the message
  7672. body.  The first column of radio buttons specifies the message type to
  7673. create.  These can be:
  7674.  
  7675.     Compose a new Message
  7676.     Reply to Message
  7677.     Forward Message
  7678.     Edit Message
  7679.  
  7680. Which buttons appear depends on the way the Compose Message window was
  7681. called.
  7682.  
  7683. "New Message" and "Edit Message" appear if a message was selected from the
  7684. PENDING or QUEUED folders and the COMPOSE MESSAGE command icon was
  7685. selected or the "Edit..." menu item was selected from the Messages menu.
  7686. The "Edit Message" button is initially highlighted.
  7687.  
  7688. "New Message", "Reply to Message", and "Forward Message" appear if a
  7689. message was selected from an input folder (such as INBOX) and the COMPOSE
  7690. MESSAGE command icon was selected or one of the "Reply" or "Forward..."
  7691. menu items were selected from the Messages menu.  If a "Reply" sub-menu
  7692. item was selected, the "Reply to Message" button will be initially
  7693. highlighted.  If "Forward..." is selected, the "Forward Message" button
  7694. will be intially highlighted.
  7695.  
  7696. Only "New Message" appears and is highlighted if no message was selected,
  7697. if the "Compose.." menu item was selected, or if a message in the SENT
  7698. folder was selected.
  7699.  
  7700. "New Message" also appears if the Compose message window was activated by
  7701. a "mailto:" call from a browser.  If a "message=" argument was provided on
  7702. the shell call to AEMail, both the "New Message" and "Edit Message" will
  7703. appear and the "Edit Message item will be highlighted..
  7704.  
  7705. If the "Edit...", "Reply" or "Forward..." menu items are selected and a
  7706. message was not selected, an error message appears.  If the "Compose..."
  7707. sub-menu is selected, a new message will always be created.  Likewise,
  7708. messages cannot be replied to or forwarded from the PENDING, QUEUED or
  7709. SENT folders.  If the "Edit..." menu item is selected, the message must
  7710. come from either the PENDING or QUEUED folder.
  7711.  
  7712. You can always change the preferred type of message to one of the other
  7713. ones allowed by clicking on the appropriate message type.
  7714.  
  7715. The checkmarked menu items under the Messages menu ("Display Full Hdr",
  7716. "Fwd Body Txt Only", and "Incl Hdr in Resp") can effect how "Reply" and
  7717. "forward" messages are constructed.  The "Incl Hdr in Resp" is the only
  7718. checkmarked item to effect "Reply" messages.  It's effect is described
  7719. below under quoting message text.
  7720.  
  7721. For forwarded messages, the normal minimum header information is, by
  7722. default, included (see "Set Minimum Headers" under the "General
  7723. Parameters" page in Section IV - Configuration).  If you want all the
  7724. headers to be included in the forwarded message, checkmark the "Display
  7725. Full Hdr" item.  If you don't want any headers to be included checkmark
  7726. the "Fwd Body Txt Only" item.  This will also prevent any attachments from
  7727. the original messages being included in the forwarded message.
  7728.  
  7729. Please Note: If the fowarded message contains attachments and "Fwd Body
  7730. Txt Only" is not checked, the full header will be sent in the forwarded
  7731. message regardless of the setting of the "Display Full Hdr" item.
  7732.  
  7733. The radio button column on the right of the window is for the encoding
  7734. method for the message body.  Four items appear here:
  7735.  
  7736.     7-Bit
  7737.     8-Bit
  7738.     quoted-printable
  7739.     encoded binary
  7740.  
  7741. The default is 8-bit.  Some Internet gateways, however, can not handle
  7742. 8-bit data - only 7-bit.  If this is the case with your situation, select
  7743. 7-bit, or if your message contains characters above ASCII 128 (most
  7744. foriegn character sets have these types of characters), select
  7745. "quoted-printable" or "encoded binary".
  7746.  
  7747. The "quoted-printable" encoding is preferred in this instance.  You will
  7748. be able to read most of the raw message except for the extended character
  7749. set characters.  The "encoded binary" encoding will encode the message in
  7750. BASE64 encoding which is totally un-readable in it's raw format.  AEMail,
  7751. however, is able to handle the translation of both "quoted-printable" and
  7752. "encoded binary" in the message body for both sending and receiving
  7753. messages.
  7754.  
  7755. If the message is a reply, the "Quote Original Message Text" box will be
  7756. checked if you have selected this option in the General Parameters page of
  7757. the Configuration Setup Window.  You can un-check this box if you don't
  7758. want the original text quoted in the message (or check it, if the default
  7759. action was not to include text).  For all other types of Compose windows,
  7760. this checkbox will be disabled.
  7761.  
  7762. The "Quote Prefix:" string gadget will indicate what is to be placed in
  7763. front of each quoted line.  This, by default, is '>'; however, you can add
  7764. whatever you like here (such as the person's initials followed by :  or
  7765. >).  You can also permanently change this field with the General
  7766. Parameters page of the Configuration Setup Window.
  7767.  
  7768. A "Quote header:" will be placed on the line in front of the quoted
  7769. material.  Currently, the default header which will appear in the Quote
  7770. Header:  string gadget is:
  7771.  
  7772.     On &(week), &(date2), at &(time), &(name) wrote:
  7773.  
  7774. The & followed by a field name in parenthesis indicates substitution of
  7775. data from the original message headers.  The values that can be
  7776. substituted are:
  7777.  
  7778.     &(name)     The Real Name of the sender of the original
  7779.                 message.  If the Real Name is not available,
  7780.                 the sender's UserId will be used instead
  7781.  
  7782.     &(subject)  The subject from the original message.  Any RE:
  7783.                 or (fwd) will be stripped.
  7784.  
  7785.     &(week)     The day of the week that the original message
  7786.                 was sent.
  7787.  
  7788.     &(date)     The date the original message was sent in the form
  7789.                 DD MMM YYYY, where DD is the day of the month,
  7790.                 MMM is month in the form Jan, Feb, Mar, etc, and
  7791.                 YYYY is the full 4 digit year.
  7792.  
  7793.     &(date1)    Same as &(date).
  7794.  
  7795.     &(date2)    The date in the form MMM DD, YYYY.
  7796.  
  7797.     &(time)     The time the original message was sent in the
  7798.                 form HH:MM xM where HH is the hour on a 12 hour
  7799.                 clock, MM is the minute, and xM is AM or PM.
  7800.  
  7801.     &(to)       The email address the message was sent to.  For
  7802.                 mailing lists this could be the name of the mailing
  7803.                 list if that is what appeared in the To: header.
  7804.  
  7805. The "Quote Header" is designed to be modified by the user and can be
  7806. changed with the string gadget.  This change is only in effect for this
  7807. message however.  You can permanently change the "Quote Header" with the
  7808. General Parameters page of the Configuration Setup Window.
  7809.  
  7810. Whether on not the quoted message's headers are to be included in the
  7811. quote is controlled by the "Incl Hdr in Resp" item under the Messages main
  7812. menu.  If this item is checked the "Date", "To", "From:", "Reply To:",
  7813. "Subject:", "cc:", and "bcc:" headers will be displayed from the original
  7814. message.  If it is not checked, no header information will be included.
  7815.  
  7816. The amount of header information in the quoted message is also controlled
  7817. by the "Display Full Hdr" item in the Messages menu.
  7818.  
  7819. The row of gadgets below the "Quote Header:" is used to specify
  7820. characteristics of your signature file if you want one.  They work in
  7821. conjunction with the full path name of your current active signature file
  7822. shown in the title bar of the Compose Message window.
  7823.  
  7824. If a signature file is present, the "Add Signature Block" box will be
  7825. checked and the path name of that signature file will appear in the title
  7826. bar.  If a signature file is not present, this checkbox will be disabled.
  7827. The default signature file is AEMail:.signature.  However, if you are a
  7828. registered user, you can change to any other signature file by clicking on
  7829. the [Select Signature] gadget.  This will call up a file requester in
  7830. which you can select the appropriate file.  The file does not have to
  7831. exist; you can create it with the [Edit Signature] gadget.
  7832.  
  7833. If you are an un-registered user, the [Select Signature] button will be
  7834. ghosted and you can only use the standard AEMail:.signature file.
  7835.  
  7836. If you want to create or edit the current selected signature file, you can
  7837. click on the [Edit Signature] button.  This will call up your editor to
  7838. allow you to create or edit the selected signature file.  After you have
  7839. edited or created your signature file in your editor, save the file and
  7840. exit from the editor.  This will return you to the COMPOSE MESSAGE window
  7841. and the "Add Signature Block" check box will be enabled.
  7842.  
  7843. If you do not want the signature block placed at the end of your message,
  7844. uncheck the Add Signature Block box.
  7845.  
  7846. Note:  if the message is being edited, the Add Signature Block box WILL
  7847. NOT be checked.  This is done to prevent two signature blocks being added
  7848. to the message.  However, rather than disable this item, it is left to
  7849. allow the user to add a signature block in the event one was not added to
  7850. the original message or you selected the "New Message" radio button.
  7851.  
  7852. The [Add Attachments] button brings up the Add Attachments Requster which
  7853. is described below.  This requester allows you to add one or multiple
  7854. files as attachments to your message.  You can bring up this requester at
  7855. any time.  If it is brought up a second time, the old attachment
  7856. information will appear in the attachment list.  You can add to this
  7857. information or delete entries as you desire.
  7858.  
  7859. The [Compose/Edit Message] gadget calls up the editor you specified in the
  7860. General Parameters page of the Configuration Setup.  If you are editing a
  7861. previously composed message, you will see that message in your editor
  7862. window.  You can make changes as appropriate.  Also, if you specified
  7863. "Quote Original Message Text" you will see the quoted text.  You can
  7864. delete and insert lines as appropriate.
  7865.  
  7866. One of the things you will NOT see in the editor window are your message
  7867. headers or the signature block unless it is an edited message.  The
  7868. signature block is always added after you compose the message.  If this is
  7869. a "new" message, you will see a blank editor screen when the editor is
  7870. first called.  Enter whatever text you wish to use in your editor's window
  7871. and then select "Save" and "Quit" from your editor's menus.  This will
  7872. return you to the Compose Message window.
  7873.  
  7874. You will not be able to edit or add headers when you [Compose/Edit
  7875. Message].  If you need to add additional headers to a message you can use
  7876. the [Add Headers] gadget to add the headers.  This feature is ONLY
  7877. available to registered users.  Un-registered users will find this gadget
  7878. ghosted.
  7879.  
  7880. Clicking on the [Add Headers] gadget will bring up the Add Headers window
  7881. which is very similar to the "Information" window for a icon which is
  7882. called from the Workbench menus.  The Add Headers window looks like this:
  7883.  
  7884.      |=============================================================|
  7885.      |[o]  Add Additional Headers                                  |
  7886.      |=============================================================|
  7887.      |                                                             |
  7888.      |         ====================================================|
  7889.      | Headers |                                                | ||
  7890.      |         |                                                | ||
  7891.      |         |                                                | ||
  7892.      |[ NEW  ] |                                                | ||
  7893.      |         ====================================================|
  7894.      |[DELETE] [                                                  ]|
  7895.      |                                                             |
  7896.      |     [ SAVE ]            [CLEAR ALL]              [CANCEL]   |
  7897.      |                                                             |
  7898.      |=============================================================|
  7899.  
  7900. Your additional headers will appear in the scrolling list.  To add a
  7901. header to the list, click on [NEW] and enter the complete header line in
  7902. the string gadget below the scrolling list.  Be sure and include the
  7903. header identifier as well as the header text.  To add this new header to
  7904. this list hit the [RETURN] key.  To transfer a header to the string
  7905. gadget for editing or deleting it, click on the header line in the
  7906. scrolling list.  Clicking on [DELETE] will then delete the header from the
  7907. list.  If you want to edit the header, make the changes you want and then
  7908. hit [RETURN].  When you are satisified with the headers you want to add,
  7909. click on [SAVE] and the new headers will be saved and added to your
  7910. message.  [CLEAR ALL] will clear all the headers from the list and
  7911. [CANCEL] will cancel the operations.
  7912.  
  7913. At the bottom of the Compose Window is a row of four action buttons as
  7914. follows:
  7915.  
  7916.  [Send Message Now] [Queue Message] [Save In Pending] [Cancel Message]
  7917.  
  7918. If you decide that you do not want to compose a message after
  7919. all, click on the [Cancel Message] button to exit the COMPOSE MESSAGE
  7920. window.
  7921.  
  7922. Otherwise, if all the correct information has been added in the
  7923. COMPOSE MESSAGE window, click on the appropriate action button
  7924. at the bottom of the window.  [Save In Pending] will save your newly
  7925. created message in the PENDING folder.  [Queue Message] will place the
  7926. message in the QUEUED folder and [Send Message Now] will send the message
  7927. provided that you are connected to you Internet Provider.  If you were
  7928. unsuccesful with sending the message, it will be stored in the QUEUED
  7929. folder to allow you to immediately send the message when you re-connect to
  7930. your Internet Service Provider.
  7931.  
  7932.                         Add Attachments Requester
  7933.                         =========================
  7934.  
  7935. When you click on the [ADD ATTACHMENTS] button on the Compose Message
  7936. Window, an Add Attachments Requester will be displayed which looks like
  7937. this:
  7938.  
  7939.      |=============================================================|
  7940.      |[o]  Add Attachments                                         |
  7941.      |=============================================================|
  7942.      |                                                             |
  7943.      |              Filename: [                              ][REQ]|
  7944.      |Attachment Description: [                                   ]|
  7945.      |  Content Type/SubType: [                                   ]|
  7946.      |                        =====================================|
  7947.      |                        | text/plain                      | ||
  7948.      |                        | text/enriched                   | ||
  7949.      |                        | text/richtext                   | ||
  7950.      |                        =====================================|
  7951.      |              Encoding: |@|           Plain Text            ||
  7952.      |                                                             |
  7953.      | Mime Type/Sub-Type   FileName                 Encoding      |
  7954.      |=============================================================|
  7955.      ||                                                         | ||
  7956.      ||                                                         | ||
  7957.      ||                                                         | ||
  7958.      ||                                                         | ||
  7959.      |=============================================================|
  7960.      |[  ADD ]         [DELETE]         [ APPLY ]         [CANCEL ]|
  7961.      |                                                             |
  7962.      |=============================================================|
  7963.  
  7964. The Filename string gadget should contain the FULL path name and filename
  7965. of the attachment.  Clicking on the [REQ] gadget will bring up a file
  7966. requester which will allow you to select the appropriate file.  The
  7967. filename portion of this string will be used as the "file=" parameter of
  7968. the Content-Type MIME header and as the "filename=" parameter of the
  7969. Content-Disposition MIME header.
  7970.  
  7971. The initial directory that is chosen for the file requester is the
  7972. directory that was set up in the "Add Attachment from Directory" string
  7973. gadget in the Configuration:  Default Path Parameters (see Configuration
  7974. Screen under IV.  Configuration above).  If you are adding multiple
  7975. attachments to the message, clicking on [REQ] will bring up the last
  7976. directory that you used.
  7977.  
  7978. If you enter a non-existant file, an error requester will be displayed
  7979. when you try to [ADD] the file to the attachment list.
  7980.  
  7981. The Attachment Description is an optional string gadget for entering a
  7982. description of the attachment.  If present, this string gadget will create
  7983. a Content-Description MIME header.
  7984.  
  7985. Content Type/SubType is a string gadget which contains the MIME Content
  7986. Type/Subtype entry which will appear on the Content-Type MIME header.
  7987. THIS IS A REQUIRED ENTRY UNLESS YOU ARE ADDING AN UUENCODED attachment.
  7988. It is not used for UUENCODED attachments.
  7989.  
  7990. A scrolling list below this gadget is used to select an appropriate
  7991. type/sub-type.  Predefined type/subtypes, as defined in RFC 1341 and
  7992. RFC 1521, are included in this list as follows:
  7993.  
  7994.     text/plain
  7995.     text/enriched
  7996.     text/richtext
  7997.     message/rfc822
  7998.     message/partial
  7999.     message/external-body
  8000.     multipart/mixed
  8001.     multipart/alternative
  8002.     multipart/digest
  8003.     multipart/parallel
  8004.     application/octet-stream
  8005.     application/postscript
  8006.     image/gif
  8007.     image/jpeg
  8008.     audio/basic
  8009.     video/mpeg
  8010.  
  8011. Also added to this list will be any additional type/subtypes added through
  8012. the mailcap file and any type/subtypes encountered when displaying
  8013. attachments during THIS RUN OF AEMAIL.  AEMail has no way to remember
  8014. differing type/subtypes that it encounters unless they are included in the
  8015. mailcap file.
  8016.  
  8017. You can also add your own type/subtype by directly entering it in the
  8018. Content Type/SubType string gadget.  Unless the type/subtype is well known
  8019. and published, you should pick one of the existing types (text/, message/,
  8020. application/, image/, audio/, or video/) and use a subtype beginning with
  8021. "x-".  As an example, you might want to define an IFF image (not part of
  8022. the mime published standard) as:
  8023.  
  8024.     image/x-iff
  8025.  
  8026. It is suggested that you use a mailcap entry for the image/x-iff to cause
  8027. it to permanently appear in the list of Content Type/Subtypes.
  8028. Attachments must be in the format you select.  AEMail will do no
  8029. conversion.  As an example, if you select application/postscript, the file
  8030. you attach should already be in postscript format.
  8031.  
  8032. Also, DO NOT use the follwing types/subtypes:
  8033.  
  8034.     message/partial
  8035.     message/external-body
  8036.     multipart/mixed
  8037.     multipart/alternative
  8038.     multipart/digest
  8039.     multipart/parallel
  8040.  
  8041. All of the multipart types are not supported except at the highest level
  8042. (specifying the initial attachment list), and this is done automatically
  8043. by the program.
  8044.  
  8045. The encoding cycle gadget has four states as follows:
  8046.  
  8047.     Plain Text
  8048.     Quoted-Printable
  8049.     Encoded Binary
  8050.     UUENCODED
  8051.  
  8052. Generally, "Plain Text" should be used for:
  8053.  
  8054.     text/
  8055.     message/
  8056.  
  8057. The exception to this is when the attachment contains characters outside
  8058. the range of ASCII 32 to ASCII 128 and you ISP can not handle 8-bit codes.
  8059. If the document you are attaching contains these characters (usually
  8060. present in documents using foriegn character sets), you should use
  8061. "Quoted-Printable" or "Encoded Binary" encoding.
  8062.  
  8063. Generally speaking "Encoded Binary" should be used for the following
  8064. types:
  8065.  
  8066.     application/
  8067.     image/
  8068.     audio/
  8069.     video/
  8070.  
  8071. "UUENCODED" should be selected if you want the attachment to be in
  8072. UUENCODED format.  You can not mix UUENCODED attachments with MIME
  8073. attachments!
  8074.  
  8075. When a type/subtype is selected, the appropriate encoding format is
  8076. automatically selected.  Of course, you can change this with the cycle
  8077. gadget if there is a need.
  8078.  
  8079. Once all of the attributes for any particular attachment are selected,
  8080. click on the [ADD] gadget to add the attachment to the attachment list.
  8081. If the Filename field or Content Type/Subtype field (other than for
  8082. UUENCODED attachments) is blank an error requester will appear indicating
  8083. that you must have a valid entry in these fields.  As many attachments as
  8084. you want can be added to this list, but you can not mix MIME type
  8085. attachments with UUENCODED attachments.
  8086.  
  8087. If you wish to delete any particular gadget, select the attachment from
  8088. the list and click on [DELETE].  There is no way to modify attachment
  8089. attributes once they have been added to the list.  If you want to do this,
  8090. first click on [DELETE], make the appropriate changes, and then click on
  8091. [ADD].
  8092.  
  8093. Once you are satisfied with your attachment list click on [APPLY].  The
  8094. Add Attachments Requester will disappear and the attachments will be
  8095. automatically added to your message after it is composed.
  8096.  
  8097. If you decide that you don't want to add attachments after all, click on
  8098. [CANCEL] and the attachments will not be added when you compose your
  8099. message.
  8100.  
  8101. Clicking on the Close Gadget at the top of the window has the same
  8102. effect as if you clicked on [CANCEL].
  8103.  
  8104. If you are editing a message which has attachments and you select the
  8105. [ADD ATTACHMENTS] button in the Compose Window and then decide you do not
  8106. want to change the attachments you have previously added, you should click
  8107. on [APPLY].  Clicking on [CANCEL] at this point will bring up a special
  8108. warning requester which says:
  8109.  
  8110.              Continuing will delete all previous attachments
  8111.                    Use APPLY if you wish to keep them.
  8112.  
  8113.              [CONTINUE]                  [APPLY ATTACHMENTS]
  8114.  
  8115. To keep the attachments you should click on [APPLY ATTACHMENTS].
  8116.  
  8117.                         IX. AEMAIL AREXX INTERFACE
  8118.  
  8119.                                Introduction
  8120.                                ------------
  8121.  
  8122. AEMail has a very powerful set of ARexx commands that can be used to
  8123. control AEMail from external ARexx scripts.  You can also execute ARexx
  8124. scripts and AmigaDOS scripts from within AEMail.
  8125.  
  8126. When you want to send commands from an ARexx script to AEMail, you must
  8127. tell ARexx how to locate the AEMail ARexx message port.  The AEMail ARexx
  8128. Port Name is normally "AEMAIL1".  You can change this port name with the
  8129. use of the "AREXXPORT=" tool type (See TOOL TYPES under Section IV.
  8130. CONFIGURATION).  The current Arexx Port Name is shown in the About message
  8131. obtained with the "About" item under the Project Menu.
  8132.  
  8133. You tell ARexx what the message port name for AEMail is by using the ARexx
  8134. ADDRESS commmand in an ARexx script like this:
  8135.  
  8136.     ADDRESS AEMAIL1
  8137.  
  8138. If you call an ARexx script from AEMail, the ADDRESS command is
  8139. automatically set to the AEMail ARexx message port.
  8140.  
  8141. There are several ways you can execute an ARexx script in AEMail.  You can
  8142. use the ARexx/DOS menu items "Send AREXX/DOS Command...", "Send Last
  8143. Command", or, if a menu title has been assigned to the ARexx script, by
  8144. the menu item with that title (see VII.  AEMAIL MENUS).  You can also bind
  8145. ARexx scripts to a function key.  You can have up to 40 selections since
  8146. the Shift, CTRL, and ALT keys can be used in conjunction with the function
  8147. keys.  When you press the appropriate function key the ARexx script bonded
  8148. to it will be executed.
  8149.  
  8150. Two event exits have also been provided which can have ARexx scripts
  8151. executed when you double click on a web address or an email address in a
  8152. message.
  8153.  
  8154. Setting the menu title, the event exits, or the function key assigned to
  8155. the command is done with the ARexx Page of the Configuration Setup (See
  8156. Section IV.  Configuration).
  8157.  
  8158. After each command directed at AEMail from an ARexx script is executed,
  8159. the standard ARexx result variable, RC, will report the success or failure
  8160. of the command.  A 0 in RC indicates that the command was understood and
  8161. executed successfully.  An RC value other than 0 indicates an error
  8162. severity indicator.  The exact error text is reported in the Arexx
  8163. AEMAIL.LASTERROR variable.
  8164.  
  8165. All of the AEMail ARexx commands also report back information if they
  8166. were executed successfully (RC = 0).  This information is reported in the
  8167. ARexx variable RESULT.  To receive this information you must supply the
  8168. following ARexx command at the beginning of the ARexx script:
  8169.  
  8170.     OPTIONS RESULTS
  8171.  
  8172. You will notice that some commands have possible negative numbers for
  8173. RESULT values.  The RESULT variable usually returns either a numeric value
  8174. or a string.  If a numeric value is returned and if it is positive and
  8175. above zero, the expected result was achieved.  If the value was 0 or
  8176. negative, the expected result was not achieved.  Some commands that
  8177. normally return strings in the RESULT variable may also return a NULL
  8178. string or a negative numeric value.  The negative numeric value is used to
  8179. denote various reasons the string value was not returned.  If there is
  8180. only one reason, the command will normally return a "0" or a NULL value;
  8181. but if there is more than one reason, the additional reasons will be
  8182. indicated with a negative number.  An example would be a command that is
  8183. expected to return the Subject:  from the current message.  A result of
  8184. NULL or blank indicates that there was no Subject:  header and a result of
  8185. "-1" indicates that there is no current message.  These two conditions
  8186. need to be distinguished.
  8187.  
  8188. Below is a both a list of the currently available AEMail ARexx commands
  8189. and a section which describes each command in detail.  Many of the
  8190. commands are available to registered users only.  These will be so noted
  8191. in the command list.
  8192.  
  8193. Some of the commands are composed of multiple words.  To avoid confusion
  8194. these multiple words are sometimes separated by an underline character
  8195. ("_").  As an example "ADDRESS_BOOK" separates ADDRESS and BOOK with the
  8196. underline.  This is to avoid confusion with "ADDRESS" which is a standard
  8197. ARexx command.  If an underline is required, it will be shown in the
  8198. command syntax.
  8199.  
  8200. QUOTING:  Some command have parameters with embedded ARexx command
  8201. characters such as +, -, |, etc.  To avoid the possibilty of ARexx
  8202. interpreting these as ARexx operations, the parameter should be surrounded
  8203. by quotes (either single or double quotes).  An example of where this is
  8204. very important is the first parameter of the OKAY2 command.  Each of the
  8205. possible responses in the OKAY2 command is separated by a vertical bar
  8206. ("|") such as "OK|CANCEL".  The entire response parameter needs to be
  8207. surrounded in quotes as shown or otherwise the vertical bar will be
  8208. intrepreted by ARexx as an "inclusive or" operation.
  8209.  
  8210. Another condition requiring quoting is passing strings with embedded
  8211. spaces.  This usually requires a bit of "creative" quoting because ARexx
  8212. always strips at least one set of quotation marks from all strings.
  8213. Fortunately ARexx considers both the double quote (") and the single quote
  8214. (') as quotes.  To provide for the proper treatment of strings with
  8215. embedded spaces (such as some file and path names or title strings), you
  8216. have to use a double grouping of quotes.
  8217.  
  8218. For example:
  8219.  
  8220.     GETFILENAME '"The Title String"' '"A file name path"'
  8221.  
  8222. will send "The Title String" and "A file name path" to AEMail which will
  8223. recognize these strings as two quoted operands.
  8224.  
  8225. ARexx variables which might have embedded spaces in their contents must
  8226. also be quoted as above.  You can do this as follows:
  8227.  
  8228.     filename = "A file name path"
  8229.     title = "The Title String"
  8230.     GETFILENAME '"'title'"' '"'filename'"'
  8231.  
  8232. This ensures that ARexx, when it strips off a set of quotation marks and
  8233. replaces the variables with their contents, will also pass a set of
  8234. quotation marks around the resulting strings.  AEMail will then recognize
  8235. the passed strings as two string operands rather than many unconnected
  8236. words.
  8237.                         Synopsis of ARexx Commands
  8238.                         --------------------------
  8239.  
  8240. The following is a list of the currently available AEMail ARexx commands.
  8241. This list also indicates which commands are only available to registered
  8242. users with an (R) following the command.
  8243.  
  8244. A complete description of all of the commands and the command variations
  8245. follows this list.
  8246.  
  8247. ADDRESS_BOOK (R)    Manipulates the AEMail Address Book
  8248. BCC (R)             Returns the BCC header in a message
  8249. CC (R)              Returns the CC header in a message
  8250. COMPOSE             Composes a message
  8251. CURRENT IS SELECTED Makes the selected message current
  8252. DATE (R)            Returns the DATE header in a message
  8253. EXTRACT (R)         Parses a name string to real name or email address
  8254. FIRST (R)           Selects first message in folder or name in name string
  8255. FLAGS (R)           Returns the flags in a message
  8256. FOLDER (R)          Returns information on folders
  8257. FROM (R)            Returns the FROM header in a message
  8258. GETCLIP (R)         Get a clip from the clipboard
  8259. GETFILENAME         Brings up the AEMail file requester
  8260. GETLISTITEM         Brings up the AEMail list view requester
  8261. GETNUMBER           Brings up the AEMail numeric requester
  8262. GETSIZE (R)         Returns the size of a message or message body
  8263. GETSTRING           Brings up the AEMail string requester
  8264. GETVAR              Gets a variable from message
  8265. LAST (R)            Selects last message in a folder
  8266. MESSAGE (R)         Sets various flags in a message
  8267. NEXT (R)            Selects next message in folder or name in name string
  8268. OKAY1               Brings up AEMail notification requester
  8269. OKAY2               Brings up AEMail notification requester with responses
  8270. PREVIOUS (R)        Selects the previous message in a folder
  8271. QUEUE               Queues a passed message
  8272. QUIT                Terminates AEMail
  8273. REPLYTO (R)         Returns the REPLY-TO header in a message
  8274. SAVE (R)            Saves a message or message text
  8275. SCREENTOBACK        Brings a screen to the back of the display
  8276. SCREENTOFRONT       Brings a screen to the front of the display
  8277. SUBJECT (R)         Returns the SUBJECT header in a message
  8278. TO (R)              Returns the TO header in a message
  8279.  
  8280.  
  8281.                               ARexx Commands
  8282.                               --------------
  8283.  
  8284. The following is a description of all of the currently available AEMail
  8285. ARexx commands in alphabetical order.  Shown with each of the commands is
  8286. what you can expect to have returned in the RESULT variable.  Please note
  8287. the use of the OKAY1 and OKAY2 commands.  You can use these to report back
  8288. information to the AEMail user.  These commands put up a requester with
  8289. the information you provide.
  8290.  
  8291. You will also notice in the command descriptions the use of the term
  8292. "current message".  This applies to ARexx commands only and is not the
  8293. "selected message" that is indicated by an asterick (*) in the displayed
  8294. message list; although, you can make the most recent (current) "selected
  8295. message" the "current message" (see the CURRENT IS SELECTED command below)
  8296. and you can "select" a current message (the MESSAGE SELECT command).
  8297. Initially "current message" is un-defined, but once it is defined it will
  8298. remain defined through multiple calls from ARexx scripts until AEMail
  8299. terminates or the "current message" is changed through the use of another
  8300. ARexx command.
  8301.  
  8302.  
  8303.  
  8304.                                ADDRESS_BOOK
  8305.  
  8306. This command is used to manipulate the AEMail Address Book.  There are a
  8307. number of variations of the ADDRESS_BOOK command.  They are listed below.
  8308. If the correct command keyword ("LIST", "FIND", "ADD", etc.) is not
  8309. present, an RC code of severity level 5 will be returned and
  8310. AEMAIL.LASTERROR will contain "101:  Syntax Error".
  8311.  
  8312. Note the use of the parameter called "userid".  This can be either an
  8313. email address or a referenced nickname pointing to another individual or
  8314. group entry.  When a userid is returned, you can test if it is a nickname
  8315. by using the ADDRESS_BOOK GET nickname TYPE command.
  8316.  
  8317. ***
  8318.  
  8319. Syntax: ADDRESS_BOOK LIST ALL [DESCRIPTION] [pad]
  8320.         ADDRESS_BOOK LIST GROUP [DESCRIPTION] [pad]
  8321.         ADDRESS_BOOK LIST INDIVIDUAL [DESCRIPTION] [pad]
  8322.  
  8323. This command will list the nicknames in your address book.  The operand
  8324. "ALL" will list all of the nicknames, the operand "GROUP" will list just
  8325. the group nicknames, and "INDIVIDUAL" will list just the individual
  8326. nicknames.
  8327.  
  8328. The optional keyword "DESCRIPTION" can be used to also return the
  8329. Description or Real Name field following the nickname.  In this event the
  8330. nickname will be padded out with spaces so that so that it will be a fixed
  8331. length of 11 characters (always ending with at least one space).  This
  8332. means that the description field will always start in a fixed position.
  8333.  
  8334. Normally each nickname is separated by a space.  However, this can be
  8335. changed by a specifying a pad string at the end of the command.  You can
  8336. use the LF keyword to specify a line feed or use some other character
  8337. sequence for the pad string.  As an example:  ", " will insert a comma
  8338. followed by a space between each nickname in the list.
  8339.  
  8340. RESULT: The list of nicknames separated by the pad character.
  8341.  
  8342. ***
  8343.  
  8344. Syntax: ADDRESS_BOOK FIND nickname [userid]
  8345.  
  8346. This command is used to find out if a particular userid (email address or
  8347. referenced nickname) is contained in a group entry in the Address Book.
  8348. You can explicity give the userid or the email address can be obtained
  8349. from the current message.  If the userid is not specified, both the From:
  8350. and Reply-To:  addresses from the current message will be used to check if
  8351. the email address is in the group entry specified by nickname.  The
  8352. nickname operand is required and must be a group nickname.
  8353.  
  8354. RESULT: -3          No current message if userid not given
  8355.         -2          The nickname is not for a group entry in the Address
  8356.                     Book
  8357.         -1          The nickname given is not in the Address Book.
  8358.         0           The userid was not found
  8359.         1           The userid found.  If not supplied, the userid that
  8360.                     was found was an email address from the From: address
  8361.                     in the current message.
  8362.         2           The Reply-To: address in the current message was found
  8363.                     in the group.
  8364.         3           Both the Reply-To: and From: addresses were found.
  8365.                     Note: these addresses may actually be the same.
  8366.  
  8367. ***
  8368.  
  8369. Syntax: ADDRESS_BOOK CREATE GROUP nickname ["SEND-HEADER-ONLY"|SHO],
  8370.             FROM|REPLYTO|userid description
  8371.  
  8372. This entry creates a new group entry in the Address Book.  When you create
  8373. a group entry you must have one userid (email address or referenced
  8374. nickname) entry to place in the group.  You are not allowed to have a
  8375. group without any entries.
  8376.  
  8377. The nickname for the new group must be supplied and it must not be greater
  8378. than 9 characters.  It can not, of course, match any existing nickname.
  8379.  
  8380. "SEND-HEADER-ONLY" is an optional keyword operand which sets the "Send
  8381. Header Only" flag in the group entry and must be quoted.  You can use the
  8382. shorthand abreviation "SHO" instead of the full "SEND-HEADER-ONLY" string.
  8383.  
  8384. The userid which is added can be explicity specified or it can be the
  8385. email address taken from either the From:  or Reply-To:  address in the
  8386. current message.  Use the keyword operands "FROM" or "REPLYTO" to specify
  8387. which header field in the current message is to be used.  If you specify
  8388. "REPLYTO" and that header is missing, an error condition will be returned
  8389. (see below).
  8390.  
  8391. There is no validation performed on the user_id.  If it is an email
  8392. address it should be one word without any intervening spaces.  It should
  8393. be within a quoted string to avoid confusion with ARexx special symbols.
  8394. If it is a nickname with embedded spaces it must be double quoted (two
  8395. pairs of quote marks - ie, '"........"'.
  8396.  
  8397. The description operand is placed in the "Real Name" field in the Address
  8398. Book entry and must be given.  It may have embedded spaces and should be
  8399. quoted.  If you want quotes to appear in the group description you should
  8400. use the ARexx method for including embedded quotes (i.e.,
  8401. '"....string...."' or '"'variable'"'.
  8402.  
  8403.  
  8404. RESULT: -4          The REPLYTO operand was specified and there is no
  8405.                     Reply-To: header in the current message.
  8406.         -3          No current message if userid not given
  8407.         -1          The nickname given is greater than 9 characters.
  8408.         0           The nickname given was already defined in the Address
  8409.                     Book.
  8410.         1           The group entry was successfully created.
  8411.  
  8412. ***
  8413.  
  8414. Syntax: ADDRESS_BOOK ADD TO GROUP nickname FROM
  8415.         ADDRESS_BOOK ADD TO GROUP nickname REPLYTO
  8416.         ADDRESS_BOOK ADD TO GROUP nickname userid
  8417.  
  8418. This command adds an userid (email address or referenced nickname) to an
  8419. existing group in the Address Book.  The nickname operand specifies the
  8420. group the userid is to be added to and is a required parameter.
  8421.  
  8422. The userid which is added can be explicity specified or it can be the
  8423. email address taken from either the From:  or Reply-To:  address in the
  8424. current message.  Use the keyword operands "FROM" or "REPLYTO" to specify
  8425. which header field in the current message is to be used.  If you specify
  8426. "REPLYTO" and that header is missing, an error condition will be returned
  8427. (see below).
  8428.  
  8429. There is no validation performed on the user_id.  If it is an email
  8430. address it should be one word without any intervening spaces.  It should
  8431. be within a quoted string to avoid confusion with ARexx special symbols.
  8432. If it is a nickname with embedded spaces it must be double quoted (two
  8433. pairs of quote marks - ie, '"........"'.
  8434.  
  8435.  
  8436. RESULT: -4          The REPLYTO operand was specified and there is no
  8437.                     Reply-To: header in the current message.
  8438.         -3          No current message if userid not specified.
  8439.         -2          The nickname is not for a group entry in the Address
  8440.                     Book
  8441.         -1          The nickname given was not found.
  8442.         0           The userid given was already defined in the group.
  8443.         1           The userid was successfully added to the group.
  8444.  
  8445.  
  8446. ***
  8447.  
  8448. Syntax: ADDRESS_BOOK ADD INDIVIDUAL nickname FROM [real-name]
  8449.         ADDRESS_BOOK ADD INDIVIDUAL nickname REPLYTO [real-name]
  8450.         ADDRESS_BOOK ADD INDIVIDUAL nickname userid [real-name]
  8451.  
  8452. This command adds a new individual nickname to the Address Book.  The
  8453. nickname for the new group must be supplied and it must not be greater
  8454. than 9 characters.  It can not, of course, match any existing nickname.
  8455.  
  8456. The userid which is assign to the new nickname is required and can be
  8457. explicity specified or it can be the email address taken from either the
  8458. From:  or Reply-To:  header in the current message.  Use the keyword
  8459. operands "FROM" or "REPLYTO" to specify which header field in the current
  8460. message is to be used.  If you specify "REPLYTO" and that header is
  8461. missing, an error condition will be returned (see below).
  8462.  
  8463. There is no validation performed on the user_id.  If it is an email
  8464. address it should be one word without any intervening spaces.  It should
  8465. be within a quoted string to avoid confusion with ARexx special symbols.
  8466. If it is a nickname with embedded spaces it must be double quoted (two
  8467. pairs of quote marks - ie, '"........"'.
  8468.  
  8469. The real-name operand is placed in the "Real Name" field in the Address
  8470. Book entry.  It is an optional entry.  It may have intervening spaces.  It
  8471. should be quoted.  If you want quotes to appear in the group description
  8472. you should use the ARexx method for including embedded quotes (i.e.,
  8473. '"....string...."' or '"'variable'"'.
  8474.  
  8475. If a current message is used to obtain the userid (either the "FROM" or
  8476. "REPLYTO" keyword operands) any real name supplied with the header will
  8477. take precedence over the real-name operand if it is present.
  8478.  
  8479. RESULT: -4          The REPLYTO operand was specified and there is no
  8480.                     Reply-To: header in the current message.
  8481.         -3          No current message if userid not specified.
  8482.         -1          The nickname given is greater than 9 characters.
  8483.         0           The nickname given was already defined.
  8484.         1           The nickname and userid was successfully added to the
  8485.                     Address Book.
  8486.  
  8487. ***
  8488.  
  8489. Syntax: ADDRESS_BOOK DELETE FROM GROUP nickname FROM
  8490.         ADDRESS_BOOK DELETE FROM GROUP nickname REPLYTO
  8491.         ADDRESS_BOOK DELETE FROM GROUP nickname userid
  8492.  
  8493. This command deletes a userid from the group indicated by nickname.
  8494.  
  8495. The userid which is to be deleted is required and can be explicity
  8496. specified or it can be the email address taken from either the From:  or
  8497. Reply-To:  address in the current message.  Use the keyword operands
  8498. "FROM" or "REPLYTO" to specify which header field in the current message
  8499. is to be used.  If you specify "REPLYTO" and that header is missing, an
  8500. error condition will be returned (see below).
  8501.  
  8502. There is no validation performed on the user_id.  If it is an email
  8503. address it should be one word without any intervening spaces.  It should
  8504. be within a quoted string to avoid confusion with ARexx special symbols.
  8505. If it is a nickname with embedded spaces it must be double quoted (two
  8506. pairs of quote marks - ie, '"........"'.
  8507.  
  8508. If the userid is the only userid in the group, it will not be deleted.
  8509. No group can exist without at lease one userid.  In this special case a
  8510. RESULT code of -5 will be returned.  To delete the one remaining userid
  8511. you must delete the entire group (see "ADDRESS-BOOK DELETE GROUP" below.
  8512.  
  8513. RESULT: -5          The userid specified was the only userid in the
  8514.                     group and WAS NOT DELETED.  Use the "ADDRESS_BOOK
  8515.                     DELETE GROUP" command to delete entire group.
  8516.         -4          The REPLYTO operand was specified and there is no
  8517.                     Reply-To: header in the current message.
  8518.         -3          No current message if userid not specified.
  8519.         -2          The nickname is not for a group entry in the Address
  8520.                     Book
  8521.         -1          The nickname given was not found.
  8522.         0           The userid was not present in the group.
  8523.         1           The userid was deleted from the group.
  8524.  
  8525. ***
  8526.  
  8527. Syntax: ADDRESS_BOOK DELETE GROUP nickname
  8528.  
  8529. This command deletes the entire group specified by nickname and all of
  8530. it's associated userids.
  8531.  
  8532. RESULT: -2          The nickname given is not for a group entry in the
  8533.                     Address Book
  8534.         -1          The nickname given was not found.
  8535.  
  8536.         1           The group was successfully deleted.
  8537.  
  8538. ***
  8539.  
  8540. Syntax: ADDRESS_BOOK DELETE INDIVIDUAL nickname
  8541.  
  8542. This command deletes the nickname provided.  It must be the nickname for
  8543. an individual.
  8544.  
  8545. RESULT: -2          The nickname given is for a group entry in the
  8546.                     Address Book.  No deletion was performed.
  8547.         0           The individual's nickname was not present.
  8548.         1           The individual's nickname was successfully deleted.
  8549.  
  8550. ***
  8551.  
  8552. Syntax: ADDRESS_BOOK GET nickname TYPE
  8553.  
  8554. This command obtains the type, group or individual, for the Address Book
  8555. entry specified by "nickname".
  8556.  
  8557. RESULT: -1          The nickname given does not exist.
  8558.          0          Nickname was for an individual entry.
  8559.          1          Nickname was for a group entry.
  8560.  
  8561. ***
  8562.  
  8563. Syntax: ADDRESS_BOOK GET nickname REALNAME
  8564.  
  8565. This command obtains the "Real Name" or Group Description for the Address
  8566. Book entry specified by "nickname".
  8567.  
  8568. RESULT: -1              The nickname given does not exist.
  8569.          NULL or blank  No real name was present.
  8570.          "Real Name" or group description string
  8571.  
  8572. ***
  8573.  
  8574. Syntax: ADDRESS_BOOK GET nickname USERID
  8575.  
  8576. This command obtains the userid for the Address Book entry specified by
  8577. "nickname".  This command can only be used with Individual nicknames.
  8578.  
  8579. RESULT: -2          The nickname given is not for an individual entry.
  8580.         -1          The nickname given does not exist.
  8581.          "userid"  This may be either an email address or a referenced
  8582.                     nickname.  Use the ADDRESS_BOOK GET nickname TYPE
  8583.                     command to determine if it is a nickname rather than
  8584.                     an email address.
  8585.  
  8586. ***
  8587.  
  8588. Syntax: ADDRESS_BOOK GET nickname FIRST USERID
  8589.  
  8590. This command obtains the first userid for the Address Book group entry
  8591. specified by "nickname".  This command can only be used with Group
  8592. nicknames.
  8593.  
  8594. This command must be issued before the GET NEXT USERID command described
  8595. below is issued.  When this command is issued it resets the group for
  8596. which you are attempting to obtain userids.
  8597.  
  8598. RESULT: -2          The nickname given is not for a group entry.
  8599.         -1          The nickname given does not exist.
  8600.          "userid"   This may be either an email address or a referenced
  8601.                     nickname.  Use the ADDRESS_BOOK GET nickname TYPE
  8602.                     command to determine if it is a nickname rather than
  8603.                     an email address.
  8604.  
  8605. ***
  8606.  
  8607. Syntax: ADDRESS_BOOK GET nickname NEXT USERID
  8608.  
  8609. This command obtains the next userid for the Address Book group entry
  8610. specified by "nickname".  This command can only be used with Group
  8611. nicknames.
  8612.  
  8613. A GET nickname FIRST USERID command must be issued for the same nickname
  8614. before the a GET nickname NEXT USERID command is issued.  This command
  8615. will continue to get userids for the nickname until a NULL is received
  8616. which signifies the end of list of userids for the group.  If you continue
  8617. to try to issue NEXT USERID commands after the last userid is obtained you
  8618. will get an error result as shown below.
  8619.  
  8620. RESULT: -3          A prior FIRST USERID command was not issued for this
  8621.                     group nickname.
  8622.         -2          The nickname given is not for a group entry.
  8623.         -1          The nickname given does not exist OR you have issued
  8624.                     the NEXT USERID command after the last one was
  8625.                     obtained.
  8626.          "userid"   This may be either an email address or a referenced
  8627.                     nickname.  Use the ADDRESS_BOOK GET nickname TYPE
  8628.                     command to determine if it is a nickname rather than
  8629.                     an email address.
  8630.          NULL       There are no more userids in the group.
  8631.  
  8632. ***
  8633.  
  8634. Syntax: ADDRESS_BOOK GET nickname "SEND-HEADER-ONLY-FLAG"|"SHO-FLAG"
  8635.  
  8636. This command obtains the state of the "Send Header Only" flag for the
  8637. group entry specified by "nickname".  The operand can be specified as
  8638. either "SEND-HEADER-ONLY-FLAG" or "SHO-FLAG" and must be quoted.  This
  8639. command can only be used with Group nicknames.
  8640.  
  8641. RESULT: -2          The nickname given was not for a group entry.
  8642.         -1          The nickname given does not exist.
  8643.          0          The "Send Header Only" Flag was OFF.
  8644.          1          The "Send Header Only" Flag was ON.
  8645.  
  8646. ***
  8647.  
  8648. Syntax: ADDRESS_BOOK GET nickname COUNT
  8649.  
  8650. This command obtains the count of userid entries in the group entry
  8651. specified by "nickname".  This command is can only be used with Group
  8652. nicknames.
  8653.  
  8654. RESULT: -2          The nickname given was not for a group entry.
  8655.         -1          The nickname given does not exist.
  8656.  
  8657.          n          The count of userids in the group entry.
  8658.  
  8659.  
  8660.                                    BCC
  8661.  
  8662. Syntax: BCC
  8663.  
  8664. This command returns the bcc:  header of the current message without the
  8665. bcc:.  It has no operands.
  8666.  
  8667. RESULT: -1              No current message
  8668.         NULL or blanks  No bcc: header
  8669.         bcc: header
  8670.  
  8671.  
  8672.                                     CC
  8673.  
  8674.  
  8675. Syntax: CC
  8676.  
  8677. This command returns the cc:  header of the current message without the
  8678. cc:.  It has no operands.
  8679.  
  8680. RESULT: -1              No current message
  8681.         NULL or blanks  No cc: header
  8682.         cc: header
  8683.  
  8684.  
  8685.                                  COMPOSE
  8686.  
  8687. All of the variations of the COMPOSE command bring up the AEMail compose
  8688. window for further action.  If for any reason the Compose window returns
  8689. any error such as the failure to open the Compose window or an out of
  8690. memory condition, the error will be returned in AEMAIL.LASTERROR with the
  8691. RC set to a severity level of 20.  This error will not have an error
  8692. number associated with it.
  8693.  
  8694. The syntax of the various variations of the COMPOSE command are as
  8695. follows:
  8696.  
  8697. ***
  8698.  
  8699. Syntax: COMPOSE
  8700.  
  8701. The COMPOSE command without any operands brings up the Compose window to
  8702. compose a new message.
  8703.  
  8704. RESULT: 0:          User canceled message compose.  No message composed.
  8705.         1:          Message composed and placed in PENDING folder.
  8706.         2:          Message composed and placed in QUEUED folder.
  8707.         3:          Message composed and sent.
  8708.  
  8709. ***
  8710.  
  8711. Syntax: COMPOSE NEW MESSAGE
  8712.  
  8713. The Compose window will be brought up to compose a new message.
  8714.  
  8715. RESULT: 0:          User canceled message compose.  No message composed.
  8716.         1:          Message composed and placed in PENDING folder.
  8717.         2:          Message composed and placed in QUEUED folder.
  8718.         3:          Message composed and sent.
  8719.  
  8720. ***
  8721.  
  8722. Syntax: COMPOSE REPLY
  8723.  
  8724. The Compose window will be brought up to compose a reply to the current
  8725. message using the Reply-To: address as the recipient.  If the Reply-To:
  8726. address is not available, the From:  address will be used.
  8727.  
  8728. RESULT: -1:         There is no current message defined.
  8729.          0:         The user cancelled the operation.  No message was
  8730.                     composed.
  8731.          1:         Message composed and placed in PENDING folder.
  8732.          2:         Message composed and placed in QUEUED folder.
  8733.          3:         Message composed and sent.
  8734. ***
  8735.  
  8736. Syntax: COMPOSE REPLY FROM
  8737.  
  8738. The Compose window will be brought up to compose a reply to the current
  8739. message using the From: address as the recipient.
  8740.  
  8741. RESULT: -1:         There is no current message defined.
  8742.          0:         The user cancelled the operation.  No message was
  8743.                     composed.
  8744.          1:         Message composed and placed in PENDING folder.
  8745.          2:         Message composed and placed in QUEUED folder.
  8746.          3:         Message composed and sent.
  8747.  
  8748. ***
  8749.  
  8750. Syntax: COMPOSE FORWARD [userid]
  8751.  
  8752. The Compose window will be brought up to forward the current message.  If
  8753. the userid (email address or referenced Address Book nickname) is
  8754. provided, this will be used as the recipient (To:  address) of the
  8755. forwarded message; otherwise, the To:  address will be blank and user will
  8756. have to provide it.
  8757.  
  8758. RESULT: -1:         There is no current message defined.
  8759.          0:         The user cancelled the operation.  No message was
  8760.                     composed.
  8761.          1:         Message composed and placed in PENDING folder.
  8762.          2:         Message composed and placed in QUEUED folder.
  8763.          3:         Message composed and sent.
  8764. ***
  8765.  
  8766. Syntax: COMPOSE MAILTO userid
  8767.  
  8768. The Compose window will be brought up to compose a new message to be
  8769. mailed to the recipient indicated by the userid.  The userid can be either
  8770. an Address Book nickname or a full email-address and must be given.
  8771.  
  8772. No validation is made on the userid.  If it is invalid, either the user
  8773. will receive an error when the message is sent or a message will be
  8774. received indicating "Returned mail:  User unknown".
  8775.  
  8776. RESULT: 0:          The user cancelled the operation.  No message was
  8777.                     composed.
  8778.         1:          Message composed and placed in the PENDING folder.
  8779.         2:          Message composed and placed in the QUEUED folder.
  8780.         3:          Message composed and sent.
  8781.  
  8782. ***
  8783.  
  8784. Syntax: COMPOSE "message-file-name"
  8785.  
  8786. The Compose window will be brought up and the message file indicated by
  8787. "message-file-name" will be read into the system and used as the message
  8788. to edit.  This message must have correctly formatted headers.  Only the
  8789. To:, From:, Reply-To:, Subject:, cc:, and bcc: headers will be recognized.
  8790. A blank line must separate the headers from the body of the message.
  8791.  
  8792. The "message-file-name" should be the full path name of the message file
  8793. and it should be quoted since the path will contain characters that ARexx
  8794. will attempt to interpret as operators or possibly embedded spaces.
  8795.  
  8796. Any address provided with the To: header can be either an Address Book
  8797. nickname or a full email address.  Multiple To: addresses can be provided
  8798. as well as multiple cc: or bcc: addresses.
  8799.  
  8800. No headers have to be provided with the message.  The headers can be
  8801. provided on the Compose window.  However, if this is done, a blank line
  8802. MUST precede the message body in the message file.
  8803.  
  8804. Additional RC type errors can be received by this command if the
  8805. message-file-name is invalid or an error occurred reading in the message
  8806. file.  Each of these errors have a severity level of 5 with one of the
  8807. following messages placed in the AEMAIL.LASTERROR variable:
  8808.  
  8809.     105: Error Opening Passed Message
  8810.     106: Error retrieving passed message
  8811.  
  8812. If you would like to use the File Requester to obtain the file name before
  8813. passing it to this command, you can use the GETFILENAME command to obtain
  8814. the full path name of the message.
  8815.  
  8816. No validation is made on the To:  address in the message.  If it is
  8817. invalid, either the user will receive an error when the message is sent or
  8818. a message will be received indicating "Returned mail:  User unknown".
  8819.  
  8820. RESULT: 0:          The user cancelled the operation.  No message was
  8821.                     composed.
  8822.         1:          Message composed and placed in PENDING folder.
  8823.         2:          Message composed and placed in QUEUED folder.
  8824.         3:          Message composed and sent.
  8825.  
  8826.  
  8827.  
  8828.                            CURRENT IS SELECTED
  8829.  
  8830. Syntax: CURRENT IS SELECTED
  8831.  
  8832. This command makes the currently selected message the current message.
  8833. The currently selected message is the message that is highlighted in the
  8834. message list or the message that is currently being displayed.  The
  8835. message may or may not have a selection asterick.
  8836.  
  8837. RESULT: 0           There was no selected message.
  8838.         1           Current message is now the selected message.
  8839.  
  8840.  
  8841.  
  8842.                                    DATE
  8843.  
  8844. Syntax: DATE
  8845.         DATE MDY
  8846.         DATE DMY
  8847.         DATE YMD
  8848.  
  8849. This command returns the Date:  header of the current message header
  8850. without the "Date:".
  8851.  
  8852. Without an operand, this command returns the date as it was received in
  8853. the Date:  header of the message.  With the operand "MDY" it returns the
  8854. date as mm/dd/yy.  The operand "DMY" returns the date as dd/mm/yy and
  8855. "YMD" returns yy/mm/dd.  All of the fields are two digits which means that
  8856. yy will be the last 2 digits of the year.
  8857.  
  8858. The alternate formats are provided so that the date field can be stored in
  8859. a data base such as one created with "Final Data".
  8860.  
  8861. RESULT: -1              No current message
  8862.         NULL or blanks  No Date: header
  8863.         Date: field
  8864.  
  8865.                                  EXTRACT
  8866.  
  8867. Syntax: EXTRACT REALNAME name-string
  8868.         EXTRACT USERID name-string
  8869.  
  8870. This command extracts either the REALNAME or the USERID (email address
  8871. or address book nickname) from a name string that is usually the result of
  8872. the FIRST TONAME, FIRST CCNAME, FIRST BCCNAME or NEXT NAME commands
  8873. (see below).  Because of the various formats of a name string; ie,
  8874.  
  8875.         email-address (Full Name)
  8876.         Full Name <email-address>
  8877.         email-address
  8878.         addressbook-nickname
  8879.  
  8880. it is easier to use this command rather then to use standard ARexx
  8881. commands to parse the name string.
  8882.  
  8883. If you use the ADDRESS_BOOK GET nickname TYPE command you can determine if
  8884. a userid that is returned is a nickname or email address.
  8885.  
  8886. The name-string variable should be quoted since it will contain blanks and
  8887. other characters ARexx may not like including double quote marks.  As an
  8888. example:
  8889.  
  8890.     OPTION RESULTS
  8891.     FIRST TONAME
  8892.     name=RESULT
  8893.     if name = "" THEN EXIT
  8894.     EXTRACT USERID '"'name'"'
  8895.     emailaddr=RESULT
  8896.     ADDRESS_BOOK GET '"'emailaddr'"' TYPE
  8897.     if RESULT = 0 THEN OKAY1 emailaddr" is an individual nickname."
  8898.     ELSE if RESULT = 1 THEN OKAY1 emailaddr" is a group nickname."
  8899.  
  8900. RESULT: NULL or blank   No real name if REAL-NAME operand used.
  8901.         Either the real name or userid string.
  8902.                                   FIRST
  8903.  
  8904. This command is used to select the first message in the current folder or
  8905. to select the first name string from the list of To:  or cc:  recipients.
  8906.  
  8907. ***
  8908.  
  8909. Syntax: FIRST
  8910.         FIRST NEW
  8911.         FIRST SELECTED
  8912.         FIRST DELETED
  8913.  
  8914. Without an Operand this command selects the first message in the current
  8915. selected folder as the current message.
  8916.  
  8917. With the NEW operand, this command selects the first un-read (new) message
  8918. in the current selected folder as the current message.
  8919.  
  8920. If a message is unread but deleted, it will NOT be considered an un-read
  8921. message.
  8922.  
  8923. With the SELECTED operand, this command selects the first selected
  8924. (message marked with an asterick) message in the current selected folder
  8925. as the current message.
  8926.  
  8927. With the DELETED operand, this command selects the first message marked as
  8928. deleted in the current selected folder as the current message.
  8929.  
  8930. NOTE: The order of the messages in the folder is the un-sorted order.
  8931. This generally means that the first message is the oldest message in the
  8932. folder.
  8933.  
  8934. RESULT: 0       No messages of the particular type in the folder
  8935.         1       First message is now the current message.
  8936.  
  8937. ***
  8938.  
  8939. Syntax: FIRST TONAME
  8940.         FIRST CCNAME
  8941.         FIRST BCCNAME
  8942.  
  8943. This command returns the first name from the appropriate header field
  8944. (To:, cc:, or bcc:) in the current message.  The name can be in one of the
  8945. following formats:
  8946.  
  8947.         email-address (Full Name)
  8948.         Full Name <email-address>
  8949.         email-address
  8950.         addressbook-nickname
  8951.  
  8952. Names in the header recipient lists are separated by commas; however, a
  8953. comma may be embedded within a real name if the real name is surrounded by
  8954. quotes.
  8955.  
  8956. If you wish to extract either the Full Name, email-address, or the
  8957. addressbook-nickname from the RESULT you can set the RESULT to a variable
  8958. and then use the EXTRACT command with that variable as the argument.
  8959.  
  8960. RESULT: -1              There is no current message
  8961.          NULL or blank  There are no names in this field.
  8962.          The first name in the appropriate header.
  8963.  
  8964.  
  8965.                                   FLAGS
  8966.  
  8967. Syntax: FLAGS
  8968.  
  8969. This command returns the flags for the current message.  The flags are
  8970. returned in the RESULT field as indicated below.  A message can have
  8971. multiple flags which means that a value will be returned with the two or
  8972. more values for the flags added together.  As an example, a message that
  8973. is unread and new with attachments will return a value of 11.  You will
  8974. need to use the ARexx operator for logical AND to isolate the flag you
  8975. want.
  8976.  
  8977. Here is a piece of ARexx code to isolate a message that is unread:
  8978.  
  8979.     OPTION RESULTS
  8980.  
  8981.     FLAGS
  8982.  
  8983.     IF RESULT = -1 THEN OKAY1 "There is no current message"
  8984.     ELSE DO
  8985.  
  8986.         IF RESULT & 2 THEN OKAY1 "This message is unread"
  8987.         ELSE OKAY1 "This message has been read"
  8988.  
  8989.         END
  8990.  
  8991. Note the distinction between flag values 1 (for New) and 2 (for Unread).
  8992. Generally, when a message is first read into the system both flags are
  8993. set.  If the message is read, both flags are turned off.  However, if the
  8994. message should be deleted without being read, the Unread flag will be
  8995. turned off but the New flag will remain on.  If that message then becomes
  8996. un-deleted and the New flag is still on, the Unread flag will be turned
  8997. back on.
  8998.  
  8999. RESULT: -1          No current message
  9000.         0           There is a current message but no flags are set
  9001.         1           Message is New and unread (can be deleted)
  9002.         2           Message is unread but not deleted
  9003.         4           Message is a reply
  9004.         8           Message has attachments
  9005.         16          Message has been forwarded
  9006.         32          Message is deleted
  9007.         64          Message is selected
  9008.  
  9009.  
  9010.                                   FOLDER
  9011.  
  9012. There are a number of variations of the FOLDER command.  They are listed
  9013. below:
  9014.  
  9015. ***
  9016.  
  9017. Syntax: FOLDER
  9018.  
  9019. The FOLDER command with no operands is used to return the current selected
  9020. folder name.
  9021.  
  9022. RESULT: 0           No folder currently selected
  9023.         The folder Name (i.e., "INBOX", "QUEUED", etc.)
  9024.  
  9025. ***
  9026.  
  9027. Syntax: FOLDER LIST_FOLDERS [pad]
  9028.  
  9029. This command will list all of the folders in your system.  Normally each
  9030. folder is separated by a space.  However, this can be changed by
  9031. specifying a pad string at the end of the command.  You can use the LF
  9032. keyword to specify a line feed or use some other character sequence for
  9033. the pad string.  As an example:  ", " will insert a comma followed by a
  9034. space between each folder name in the list.
  9035.  
  9036. Notice that the keyword here is LIST_FOLDERS with an underline between
  9037. LIST and FOLDERS.  If the keyword was simply LIST it might be
  9038. mis-interpreted as a folder named LIST.
  9039.  
  9040. RESULT: The list of folders separated by the pad character.
  9041.  
  9042. ***
  9043.  
  9044. Syntax: FOLDER folder-name
  9045.  
  9046. This command selects the the folder indicated by folder-name.
  9047.  
  9048. RESULT: -1: folder-name is invalid.  Could be the result of a misspelling
  9049.             of one of the operands used with the FOLDER commands so that
  9050.             the operand is mis-interpreted as a folder-name.
  9051.          0: The folder folder-name could not be selected.
  9052.          1: The folder folder-name was selected.
  9053.  
  9054. ***
  9055.  
  9056. Syntax: FOLDER DESCRIPTION
  9057.         FOLDER folder-name DESCRIPTION
  9058.         FOLDER folder-name SELECT DESCRIPTION
  9059.  
  9060. This command returns the description of either the selected folder or, if
  9061. present, the folder indicated by folder name.  If the folder name is
  9062. present, it will not become the new selected unless the SELECT keyword
  9063. immediately follows it.  This allows you to obtain the description of a
  9064. folder without selecting it.
  9065.  
  9066. NOTE:  If the folder-name is left off the command and any of the
  9067. parameters is misspelled, it could result in the misspelled parameter
  9068. being mis-interpreted as a folder-name.
  9069.  
  9070. RESULT: -1: folder-name is invalid.  Could be the result of a misspelling
  9071.             of one of the operands used with the following FOLDER commands
  9072.             so that the operand is mis-interpreted as a folder-name.
  9073.  
  9074.          The description of either the folder specified with folder-name
  9075.             or the selected folder.
  9076.  
  9077. ***
  9078.  
  9079. Syntax: FOLDER NUMBER_MESSAGES
  9080.         FOLDER folder-name NUMBER_MESSAGES
  9081.         FOLDER folder-name SELECT NUMBER_MESSAGES
  9082.  
  9083. This command returns the number of messages contained in either the
  9084. selected folder or, if present, the folder indicated by folder name.  If
  9085. the folder name is present, it will not become the new selected folder
  9086. unless the SELECT keyword immediately follows it.  This allows you to
  9087. obtain the number of messages from a folder without selecting it.
  9088.  
  9089. Please note the spelling of the operand NUMBER_MESSAGES with the underline
  9090. between NUMBER and MESSAGES.  This makes the operand string longer than a
  9091. folder-name so that it does not interfer with any existing folder-name.
  9092.  
  9093. NOTE:  If the folder-name is left off the command and any of the
  9094. parameters is misspelled, it could result in the misspelled parameter
  9095. being mis-interpreted as a folder-name.
  9096.  
  9097. RESULT: -1: folder-name is invalid.  Could be the result of a misspelling
  9098.             of one of the operands used with the following FOLDER commands
  9099.             so that the operand is mis-interpreted as a folder-name.
  9100.  
  9101.          n: The total number of messages in the folder including ones that
  9102.             are unread or deleted.
  9103.  
  9104. ***
  9105.  
  9106. Syntax: FOLDER NEW_MESSAGES
  9107.         FOLDER folder-name NEW_MESSAGES
  9108.         FOLDER folder-name SELECT NEW_MESSAGES
  9109.  
  9110. This command returns the number of new (unread) messages contained in
  9111. either the selected folder or, if present, the folder indicated by folder
  9112. name.  If the folder name is present, it will not become the new selected
  9113. folder unless the SELECT keyword immediately follows it.  This allows you
  9114. to obtain the number of new messages from a folder without selecting it.
  9115.  
  9116. If a message is unread but deleted, it will not be included in the count
  9117. of new messages.
  9118.  
  9119. Please note the spelling of the operand NEW_MESSAGES with the underline
  9120. between NEW and MESSAGES.  This makes the operand string longer than a
  9121. folder-name so that it does not interfer with any existing folder-name.
  9122.  
  9123. NOTE:  If the folder-name is left off the command and any of the
  9124. parameters is misspelled, it could result in the misspelled parameter
  9125. being mis-interpreted as a folder-name.
  9126.  
  9127. RESULT: -1: folder-name is invalid.  Could be the result of a misspelling
  9128.             of one of the operands used with the following FOLDER commands
  9129.             so that the operand is mis-interpreted as a folder-name.
  9130.  
  9131.          n: The number of new or unread messages in the folder.
  9132.  
  9133. ***
  9134.  
  9135. Syntax: FOLDER DELETED_MESSAGES
  9136.         FOLDER folder-name DELETED_MESSAGES
  9137.         FOLDER folder-name SELECT DELETED_MESSAGES
  9138.  
  9139. This command returns the number of deleted messages contained in either
  9140. the selected folder or, if present, the folder indicated by folder name.
  9141. If the folder name is present, it will not become the new selected folder
  9142. unless the SELECT keyword immediately follows it.  This allows you to
  9143. obtain the number of deleted messages from a folder without selecting it.
  9144.  
  9145. Please note the spelling of the operand DELETED_MESSAGES with the
  9146. underline between DELETED and MESSAGES.  This makes the operand string
  9147. longer than a folder-name so that it does not interfer with any existing
  9148. folder-name.
  9149.  
  9150. NOTE:  If the folder-name is left off the command and any of the
  9151. parameters is misspelled, it could result in the misspelled parameter
  9152. being mis-interpreted as a folder-name.
  9153.  
  9154. RESULT: -1: folder-name is invalid.  Could be the result of a misspelling
  9155.             of one of the operands used with the following FOLDER commands
  9156.             so that the operand is mis-interpreted as a folder-name.
  9157.  
  9158.          n: The number of deleted messages in the folder.
  9159.  
  9160. ***
  9161.  
  9162.                                    FROM
  9163.  
  9164. Syntax: FROM
  9165.  
  9166. This command returns the From:  header of the current message without the
  9167. "From:  ".  It has no operands.
  9168.  
  9169. RESULT: -1              No current message
  9170.         NULL or blanks  No From: header
  9171.         From: header
  9172.  
  9173.                                  GETCLIP
  9174.  
  9175. Syntax: GETCLIP
  9176.         GETCLIP n
  9177.         GETCLIP UNIT n
  9178.  
  9179. This command will return the current contents of the clipboard in the
  9180. result variable.  If "UNIT n" or "n" is not specified, it will be from the
  9181. current active clipboard.  If "UNIT n" or "n" (without UNIT) is specified
  9182. it will be from the clipboard unit specified by n.
  9183.  
  9184. If the clipboard unit is specified, the current active clipboard will be
  9185. changed to that unit UNLESS the clipboard unit was non-existant.
  9186.  
  9187. RESULT: NULL or blank   This clipboard unit is empty or non-existant.
  9188.         Data from the clipboard unit.
  9189.  
  9190. ***
  9191.  
  9192. Syntax: GETCLIP UNIT
  9193.  
  9194. This command will return the current active clipboard unit number.  Notice
  9195. that is similar to the previous command WITHOUT the clipboard unit number
  9196. (n).
  9197.  
  9198. RESULT: n       This current active clipboard unit number.
  9199.  
  9200.  
  9201.                                GETFILENAME
  9202.  
  9203. Syntax: GETFILENAME
  9204.         GETFILENAME title
  9205.         GETFILENAME title defaultpath
  9206.  
  9207. This command brings up the AEMail file requester so you can solicit file
  9208. names that can be used with commands that require file names.
  9209.  
  9210. If no operands are provided with this command, the file requester will
  9211. have "ARexx File Request" as the default title in the requester and a
  9212. default path of PROGDIR: (the directory from which AEMail was called).
  9213.  
  9214. The second form of this command allows you to provide your own title in
  9215. the file requester which may be more descriptive of what kind of file you
  9216. want.
  9217.  
  9218. The third form gives the user the ability to provide both a title and a
  9219. default file path and (if wanted) filename.  This is particularly useful
  9220. if you want to reference a different directory than your program
  9221. directory.  A default filename can be part of this path.
  9222.  
  9223. NOTE: If you supply a default path without a filename (directory only) you
  9224. must end the string with ":" or "/" to indicate that it is a directory and
  9225. not a filename path.
  9226.  
  9227. Be very careful in using this command since this is one that will require
  9228. "creative" quoting to insure that you have no more than two operand
  9229. strings.  As an example you should use something like this:
  9230.  
  9231.     GETFILENAME '"The Title String"' '"A file name path"'
  9232.  
  9233. This will send "The Title String" and "A file name path" to AEMail which
  9234. will recognize these strings as two quoted operands.
  9235.  
  9236. RESULT:  NULL or blank if the no filename was entered or the requester was
  9237.             cancelled.
  9238.          The full path and filename of the file that was selected.
  9239.  
  9240.                                GETLISTITEM
  9241.  
  9242. Syntax: GETLISTITEM list
  9243.         GETLISTITEM list title
  9244.  
  9245. This command brings up the AEMail list view requester so the user can
  9246. solicit a member of the list.  The operand list is a list of items, each
  9247. member of the list being separated by a line feed.  Many of the AEMail
  9248. commands can supply such a list.  As an example, "ADDRESS_BOOK LIST GROUP
  9249. DESCRIPTION LF" will supply a list of group Address Book entries and their
  9250. descriptions separated by line feeds.  Another example is "LIST_FOLDERS LF"
  9251. which will provide a list of all the folders in the system.
  9252.  
  9253. The list should be a quoted variable such as:
  9254.  
  9255.     ADDRESS_BOOK LIST GROUP DESCRIPTION LF
  9256.     grplist = RESULT
  9257.     GETLISTITEM "'"grplist"'"
  9258.  
  9259. This will insure that the entire list is treated as a single variable.
  9260.  
  9261. The second operand is the title that you want for the list view.  If this
  9262. operand is not provided, the list view requester will have "ARexx Select
  9263. List Item" as the default title.  The title should also be quoted.
  9264.  
  9265. When the list view is displayed and an item selected from the list it will
  9266. appear in a string gadget below the listview.  You can modify the
  9267. information in this string gadget if you wish.  An [OK] and [CANCEL]
  9268. gadget will also be displayed.  If you click on [OK] or press RETURN, the
  9269. information in the string gadget will be returned in the RESULT variable.
  9270.  
  9271. RESULT:  NULL or blank if the string gadget is blank or the requester was
  9272.             cancelled.
  9273.          The string that was entered in the string gadget at the bottom of
  9274.             the listview.
  9275.                                 GETNUMBER
  9276.  
  9277. Syntax: GETNUMBER
  9278.         GETNUMBER title
  9279.         GETNUMBER title default
  9280.         GETNUMBER title default min
  9281.         GETNUMBER title default min max
  9282.  
  9283. This command brings up the AEMail numeric requester so you can solicit a
  9284. numeric value.
  9285.  
  9286. If no operands are provided with this command, the numeric requester will
  9287. have "ARexx Enter Number" as the default title in the requester and a
  9288. default value of 0.
  9289.  
  9290. The second form of this command allows you to provide your own title in
  9291. the numeric requester which may be more descriptive of what purpose you
  9292. want the number for.
  9293.  
  9294. The third form gives the user the ability to provide both a title and a
  9295. default numeric value.
  9296.  
  9297. The fourth form gives you the ability to provide a minimum value that can
  9298. be entered, and the fifth for allows both a minimum or maximum value.   f
  9299. a value outside this range is entered, the screen will flash.  Also, the
  9300. minimum and maximum limits are given in a text string below the numeric
  9301. entry gadget.
  9302.  
  9303. Be very careful in using this command since this is one that will require
  9304. "creative" quoting for the title to insure that strings between embedded
  9305. spaces are not interpreted as part of the numeric values.  As an example
  9306. you should use something like this:
  9307.  
  9308.     GETNUMBER '"Enter a number between 3 & 7"' 5 3 7
  9309.  
  9310. This will place "Enter a number between 3 & 7" in the title bar of the
  9311. requester, use 5 as the default value in the numeric entry gadget, and set
  9312. the minimum and maximum possibilities to 3 and 7 respectively.  This will
  9313. also recognize the full title string as a proper quoted operand.
  9314.  
  9315. The numeric entry gadget is followed by a [+] (increment) and a [-]
  9316. (decrement) gadget.  Clicking on one or the other of these gadgets will
  9317. increment or decrement the value in the numeric entry gadget.  This value
  9318. can not decrement below the minimum value or 0 (if no minimum is given) or
  9319. increment above the maximum value.
  9320.  
  9321. The numeric entry gadget is in "replace" mode so that entering a number
  9322. will replace what was previously there.  Hitting [OK] or pressing the
  9323. RETURN key will terminate the requester with the numeric value entered
  9324. returned in the RESULT variable.
  9325.  
  9326. RESULT:  NULL or blank if the the requester was cancelled.
  9327.           n     The numeric value entered in the requester.
  9328.  
  9329.                                  GETSIZE
  9330.  
  9331. Syntax: GETSIZE MESSAGE
  9332.         GETSIZE TEXT
  9333.  
  9334. This command will get the size of the Current Message.  If the operand
  9335. "MESSAGE" is given, it will be the size of the complete message.  If the
  9336. operand "TEXT" is given, it will be only the size of the text portion of
  9337. the message (Message size less the header size and any attachment size).
  9338.  
  9339. RESULT: 0       No Current Message
  9340.         The size of the Current Message or just the text size.
  9341.  
  9342.                                 GETSTRING
  9343.  
  9344. Syntax: GETSTRING
  9345.         GETSTRING title
  9346.         GETSTRING title defaultstring
  9347.  
  9348. This command brings up the AEMail string requester so you can solicit a
  9349. string from the user.
  9350.  
  9351. If no operands are provided with this command, the string requester will
  9352. have "ARexx Enter String" as the default title in the requester with no
  9353. default string.
  9354.  
  9355. The second form of this command allows you to provide your own title in
  9356. the string requester which may be more descriptive of what purpose you
  9357. want the string for.
  9358.  
  9359. The third form gives the user the ability to provide both a title and a
  9360. default string that will appear in the requester when it is first brought
  9361. up.
  9362.  
  9363. Be very careful in using this command since this is one that will require
  9364. "creative" quoting to insure that you have no more than two operand
  9365. strings.  As an example you should use something like this:
  9366.  
  9367.     GETSTRING '"Enter a Folder Name"' '"INBOX"'
  9368.  
  9369. This will send "Enter a Folder Name" and "INBOX" to AEMail which will
  9370. recognize these strings as two separate quoted operands.  Since INBOX is
  9371. one word, it does not have to have the special quoting on it but can be
  9372. simply 'INBOX'.
  9373.  
  9374. RESULT:   NULL or blank if the no string was entered or the requester was
  9375.             cancelled.
  9376.           The string that was entered in the requester.
  9377.  
  9378.                                   GETVAR
  9379.  
  9380. Syntax: GETVAR
  9381.  
  9382. When you are displaying a message and you double click on a message line,
  9383. the Clipboard Window appears.  If you hit one of the function keys to call
  9384. an ARexx script, the line currently being displayed in the clipboard
  9385. string will be transferred to a special variable.
  9386.  
  9387. In your ARexx script you can use GETVAR to extract that string.  If the
  9388. string was an email or web address, your script can use the variable thus
  9389. obtained to send a message to the email address or to call your web
  9390. browser to go to the web address.
  9391.  
  9392. RESULT: The string that was in the clipboard line.
  9393.                                    LAST
  9394.  
  9395. Syntax: LAST
  9396.         LAST NEW
  9397.         LAST SELECTED
  9398.         LAST DELETED
  9399.  
  9400. Without an Operand this command selects the last message in the current
  9401. selected folder as the current message.
  9402.  
  9403. With the NEW operand, this command selects the last un-read (new) message
  9404. in the current selected folder as the current message.
  9405.  
  9406. If a message is unread but deleted, it will NOT be considered an un-read
  9407. message.
  9408.  
  9409. With the SELECTED operand, this command selects the last selected
  9410. (message marked with an asterick) message in the current selected folder
  9411. as the current message.
  9412.  
  9413. With the DELETED operand, this command selects the last message marked as
  9414. deleted in the current selected folder as the current message.
  9415.  
  9416. NOTE: The order of the messages in the folder is the un-sorted order.
  9417. This generally means that the last message is the newest message in the
  9418. folder.
  9419.  
  9420. RESULT: 0       No messages of the particular type in the folder
  9421.         1       Last message is now the current message.
  9422.  
  9423.  
  9424.                                  MESSAGE
  9425.  
  9426. This command is used to set various flags on the Current Message.  After
  9427. the execution of this command, the message list, if it is currently being
  9428. displayed, will be re-displayed with the changed status.  The forms of
  9429. this command are as follows:
  9430.  
  9431. Syntax: MESSAGE SELECT
  9432.  
  9433. This command marks the Current Message as selected.
  9434.  
  9435. RESULT: -1  There is no Current Message.
  9436.          0  The Current Message is already marked as selected.
  9437.          1  The Current Message is now marked as selected.
  9438.  
  9439. ***
  9440.  
  9441. Syntax: MESSAGE UNSELECT
  9442.  
  9443. This command marks the Current Message as un-selected.
  9444.  
  9445. RESULT: -1  There is no Current Message.
  9446.          0  The Current Message is not marked as selected.
  9447.          1  The Current Message is now marked as un-selected.
  9448.  
  9449. ***
  9450.  
  9451. Syntax: MESSAGE DELETE
  9452.  
  9453. This command marks the Current Message as deleted.
  9454.  
  9455. RESULT: -1  There is no Current Message.
  9456.          0  The Current Message is already marked as deleted.
  9457.          1  The Current Message is now marked as deleted.
  9458.  
  9459. ***
  9460.  
  9461. Syntax: MESSAGE UNDELETE
  9462.  
  9463. This command marks the Current Message as not deleted.
  9464.  
  9465. RESULT: -1  There is no Current Message.
  9466.          0  The Current Message is not currently marked as deleted.
  9467.          1  The Current Message is now no longer marked as deleted.
  9468.  
  9469. ***
  9470.  
  9471. Syntax: MESSAGE READ
  9472.  
  9473. This command marks the Current Message as being read.
  9474.  
  9475. RESULT: -1  There is no Current Message.
  9476.          0  The Current Message is already marked as being read.
  9477.          1  The Current Message is now marked as being read.
  9478.  
  9479. ***
  9480.  
  9481. Syntax: MESSAGE MAKE NEW
  9482.  
  9483. This command marks the Current Message as unread or new.
  9484.  
  9485. NOTE: If the message was marked as deleted, only the "new" flag is set;
  9486. otherwise, both the "new" and "unread" flags are set.
  9487.  
  9488. RESULT: -1  There is no Current Message.
  9489.          0  The Current Message is already marked as unread (new).
  9490.          1  The Current Message is now marked as unread.
  9491.  
  9492. ***
  9493.  
  9494. Syntax: MESSAGE SELECT ALL
  9495.  
  9496. All messages in the current selected folder are marked as selected.  This
  9497. command does not change the Current Message status.
  9498.  
  9499. RESULT:  0  There are no messages in the selected folder.
  9500.          1  All of the messages in the selected folder are marked as
  9501.             selected.
  9502.  
  9503. ***
  9504.  
  9505. Syntax: MESSAGE SELECT NONE
  9506.         MESSAGE UNSELECT ALL
  9507.  
  9508. This command can be expressed in either form above.
  9509.  
  9510. All messages in the current selected folder are marked as un-selected.
  9511. This command does not change the Current Message status.
  9512.  
  9513. RESULT:  0  There are no messages in the selected folder.
  9514.          1  All of the messages in the selected folder are now marked as
  9515.             un-selected.
  9516.  
  9517.                                    NEXT
  9518.  
  9519. This command is used to select the next message in the current folder or
  9520. to select the next name string from the list of To:  or cc:  recipients.
  9521.  
  9522. ***
  9523.  
  9524. Syntax: NEXT
  9525.         NEXT NEW
  9526.         NEXT SELECTED
  9527.         NEXT DELETED
  9528.  
  9529. Without an operand this command selects the next message, regardless of
  9530. it's status, in the current selected folder as the current message.
  9531.  
  9532. With the NEW operand, this command selects the next un-read (new) message
  9533. in the current selected folder as the current message.
  9534.  
  9535. If a message is unread but deleted, it will NOT be considered an un-read
  9536. message.
  9537.  
  9538. With the SELECTED operand, this command selects the next selected (message
  9539. marked with an asterick) message in the current selected folder as the
  9540. current message.
  9541.  
  9542. With the DELETED operand, this command selects the next message marked as
  9543. deleted in the current selected folder as the current message.
  9544.  
  9545. NOTE:  The order of the messages in the folder is the un-sorted order.
  9546. This generally means that the order of the messages in the folder is that
  9547. older messages are before newer messages.
  9548.  
  9549. RESULT: 0       No more messages of the particular type are in the folder.
  9550.                 At the end of the message list.
  9551.         1       The next message is now the current message.
  9552.  
  9553. ***
  9554.  
  9555. Syntax: NEXT NAME
  9556.  
  9557. This command returns the next name from the header field that was
  9558. referenced by the last FIRST command.  A FIRST TONAME, FIRST CCNAME, or
  9559. FIRST BCCNAME command must have been issued prior to issuing the first
  9560. NEXT NAME command.  Each NEXT NAME command that is issued retrieves the
  9561. next name in that header field.  Once the end of the name list is reached,
  9562. another FIRST command must be issued before another NEXT NAME command is
  9563. issued.  The name can be in one of the following formats:
  9564.  
  9565.         email-address (Full Name)
  9566.         Full Name <email-address>
  9567.         email-address
  9568.         addressbook-nickname
  9569.  
  9570. Names in the header recipient lists are separated by commas; however, a
  9571. comma may be embedded within a real name if the real name is surrounded by
  9572. quotes.
  9573.  
  9574. If you wish to extract either the Full Name, email-address, or the
  9575. addressbook-nickname from the RESULT you can set the RESULT to a variable
  9576. and then use the EXTRACT command with that variable as the arguement.
  9577.  
  9578. RESULT: -2              The name string has not been started with the
  9579.                         FIRST command.
  9580.          NULL or blank  You are at the end of the list.  There are no 
  9581.                         more names in the current header field.
  9582.          The next name in the appropriate header.
  9583.  
  9584.                                   OKAY1
  9585.  
  9586. Syntax: OKAY1 text
  9587.  
  9588. This commands presents the AEMail notification requester containing the
  9589. supplied text.  If there are any ARexx specific command operators within
  9590. the text stream, the stream should be surrounded in quotes.
  9591.  
  9592. The notification requester has one button marked "Continue".  Clicking on
  9593. this button will terminate the requester and the OKAY1 command.
  9594.  
  9595. Warning: Be careful of the size of the text string that you pass to this
  9596. command.  If the string is too long without intervening line feeds, the
  9597. "Continue" button could be positioned off the screen and you will have no
  9598. way to terminate the requester.  This can be particularly true of returned
  9599. strings that are being displayed.  It is best to use the ARexx LEFT()
  9600. function to insure you have a short enough string.
  9601.  
  9602. RESULT: 1           Always returned
  9603.  
  9604.  
  9605.                                   OKAY2
  9606.  
  9607. Syntax: OKAY1 responses text
  9608.  
  9609. This commands presents the AEMail notification requester containing the
  9610. supplied text.  If there are any ARexx specific command operators within
  9611. the text stream, the stream should be surrounded in quotes.
  9612.  
  9613. "responses" provides a list of possible responses to the requester.  Any
  9614. number of responses can be provided.  Each response must be separated by
  9615. the vertical bar ("|").  The entire response string must be surrounded by
  9616. quote marks.
  9617.  
  9618. The notification requester has as many buttons as they are responses.  The
  9619. wording in these buttons is controlled by the response string.  Clicking
  9620. on any of these buttons will terminate the requester and the OKAY2
  9621. command.
  9622.  
  9623. RESULT: 0           The last response in the response string was selected.
  9624.         1           The first response was selected.
  9625.         n           The second through nth (last - 1) response was selected.
  9626.  
  9627.  
  9628.                                  PREVIOUS
  9629. Syntax: PREVIOUS
  9630.         PREVIOUS NEW
  9631.         PREVIOUS SELECTED
  9632.         PREVIOUS DELETED
  9633.  
  9634. Without an operand this command selects the previous message, regardless
  9635. of it's status, in the current selected folder as the current message.
  9636.  
  9637. With the NEW operand, this command selects the previous un-read (new)
  9638. message in the current selected folder as the current message.
  9639.  
  9640. If a message is unread but deleted, it will NOT be considered an un-read
  9641. message.
  9642.  
  9643. With the SELECTED operand, this command selects the previous selected
  9644. (message marked with an asterick) message in the current selected folder
  9645. as the current message.
  9646.  
  9647. With the DELETED operand, this command selects the previous message marked
  9648. as deleted in the current selected folder as the current message.
  9649.  
  9650. NOTE:  The order of the messages in the folder is the un-sorted order.
  9651. This generally means that the order of the messages in the folder is that
  9652. older messages are before newer messages.
  9653.  
  9654. RESULT: 0       No more messages of the particular type are in the folder.
  9655.                 At the beginning of the message list.
  9656.         1       The next previous is now the current message.
  9657.  
  9658.  
  9659.  
  9660.                                   QUEUE
  9661.  
  9662. Syntax: QUEUE "message-file-name" [MAILTO userid]
  9663.  
  9664. The message file indicated by "message-file-name" will be read into the
  9665. system and will be placed in the QUEUED folder.  This message must have
  9666. correctly formatted headers.  A blank line must separate the headers from
  9667. the body of the message.
  9668.  
  9669. The "message-file-name" should be the full path name of the message file
  9670. and it should be quoted since the path will contain characters that ARexx
  9671. will attempt to interpret as operators.  It may also contain embedded
  9672. spaces.  If it does contain embedded spaces, double quote pairs must be
  9673. used, ie. '"filename string"' or '"'variable'"'.
  9674.  
  9675. Any address provided with the To: header can be either an Address Book
  9676. nickname or a full email address.  Multiple To: addresses can be provided
  9677. as well as multiple cc: or bcc: addresses.
  9678.  
  9679. Instead of a To: address provided in the message the optional MAILTO
  9680. keyword can be used to provide a userid which can be an Address Book
  9681. nickname or an email address.  The MAILTO address will be added to any
  9682. addresses provide with a To: header.
  9683.  
  9684. If the From: or Reply-To: addresses are not given, these addresses will be
  9685. taken from the default From: and Reply-To addresses.
  9686.  
  9687. Any Date: header is ignored since the Date: header will be constructed
  9688. when the message is sent.
  9689.  
  9690. Any other non-standard headers can be supplied in the message file and
  9691. they will be included with the message.
  9692.  
  9693. Only the To:  header has to be provided unless the MAILTO parameter is
  9694. given.  If the MAILTO parameter is used, no headers have to be provided
  9695. with the message.  However, if this is done, a blank line MUST be the
  9696. first line in the message file.
  9697.  
  9698. Additional RC type errors can be received by this command if the
  9699. message-file-name is invalid or an error occurred reading in the message
  9700. file.  Each of these errors have a severity level of 5 with one of the
  9701. following messages placed in the AEMAIL.LASTERROR variable:
  9702.  
  9703.     105: Error Opening Passed Message
  9704.     106: Error retrieving passed message
  9705.  
  9706. No validation is made on the To:  address in the message.  If it is
  9707. invalid, either the user will receive an error when the message is sent or
  9708. a message will be received indicating "Returned mail:  User unknown".
  9709.  
  9710. RESULT: 1:          Message was placed in the QUEUED folder.
  9711.  
  9712.  
  9713.  
  9714.                                    QUIT
  9715. Syntax: QUIT
  9716.  
  9717. This command will terminate AEMail.  It operates silently so no messages
  9718. will appear.
  9719.  
  9720. After issuing this command, you can not issue any more commands to AEMail
  9721. since AEMail and the AEMail ARexx Port will no longer be there to receive
  9722. amy commands.
  9723.  
  9724. RESULT: None
  9725.  
  9726.                                  REPLYTO
  9727.  
  9728. Syntax: REPLYTO
  9729.  
  9730. This command returns the Reply-To:  header of the current message without
  9731. the "Reply-To:  ".  It has no operands.
  9732.  
  9733. RESULT: -1              No current message
  9734.         NULL or blanks  No Reply-To: header
  9735.         Reply-To: header
  9736.                                    SAVE
  9737.  
  9738. This command can save the current message or selected messages or the text
  9739. portion of a message to a file.  The current message or current message
  9740. text can also be directly returned in the RESULT variable.  The Current
  9741. Message text can also be saved to the clipboard.
  9742.  
  9743. The various forms of this command are given below:
  9744.  
  9745. Syntax: SAVE MESSAGE
  9746.  
  9747. This command will return the Current Message in the RESULT variable. This
  9748. will be the complete message including all headers, message body, and all
  9749. attachments.
  9750.  
  9751. WARNING: This will return only the first 4092 characters of the current
  9752. message.  Line Feed characters will be included at the end of each line in
  9753. the message.
  9754.  
  9755. You can use the GETSIZE MESSAGE command to obtain the size of the message
  9756. to see if it will fit.
  9757.  
  9758. RESULT: NULL or blank       There is no Current Message
  9759.         The message (up to 4092 characters)
  9760.  
  9761. ***
  9762.  
  9763. Syntax: SAVE MESSAGE [TO] filename
  9764.  
  9765. This command will save the Current Message to the file whose complete path
  9766. and file name is filename.  This should be a quoted variable.  You can
  9767. solicit a filename by using the GETFILENAME command before issuing this
  9768. command.
  9769.  
  9770. The keyword TO is optional.
  9771.  
  9772. The message saved is the complete message including all headers, message
  9773. body, and all attachments.  Except for available disk space, there is no
  9774. limit on the size of the message.  Line Feed characters will be included
  9775. at the end of each line in the message.
  9776.  
  9777. RESULT:  0      There is no current message
  9778.          1      The current message has been saved.
  9779.  
  9780. ***
  9781.  
  9782. Syntax: SAVE SELECTED MESSAGES [TO] filename
  9783.  
  9784. This command will save all of the selected messages in the current
  9785. selected folder to the file whose complete path and file name is filename.
  9786. This should be a quoted variable.  You can solicit a filename by using the
  9787. GETFILENAME command before issuing this command.
  9788.  
  9789. All of the messages will be saved in the single file specified as a block
  9790. of messages.
  9791.  
  9792. The keyword TO is optional.
  9793.  
  9794. The messages saved include the complete message including all headers,
  9795. message body, and all attachments.  Except for available disk space, there
  9796. is no limit on the size of the message.  Line Feed characters will be
  9797. included at the end of each line in the message.
  9798.  
  9799. RESULT:  0      There is no messages selected
  9800.          1      The current message has been saved.
  9801.  
  9802. ***
  9803.  
  9804. Syntax: SAVE TEXT
  9805.         SAVE TEXT NOLF
  9806.  
  9807. This command will return the text body of the Current Message in the
  9808. RESULT variable.  This will be only the body text without headers or
  9809. attachments.
  9810.  
  9811. Normally the text is returned with a line feed separating each line.  If
  9812. you use the "NOLF" operand, this line feed will be left off.  This means
  9813. that the body lines will be one continuous string of data.  This can be
  9814. very helpful if you have a short message generated by a forms command sent
  9815. by email in a web page.
  9816.  
  9817. WARNING:  This will return only the first 4092 characters of the current
  9818. message body text.  Line Feed characters will be included at the end of
  9819. each line in the message unless NOLF is specified.
  9820.  
  9821. You can use the GETSIZE TEXT command to obtain the size of the message
  9822. body to see if it will fit.
  9823.  
  9824. RESULT: NULL or blank       There is no Current Message
  9825.         The message text (up to 4092 characters)
  9826.  
  9827. ***
  9828.  
  9829. Syntax: SAVE TEXT [TO] filename
  9830.  
  9831. This command will save the text body of the Current Message to the file
  9832. whose complete path and file name is filename.  This should be a quoted
  9833. variable.  You can solicit a filename by using the GETFILENAME command
  9834. before issuing this command.
  9835.  
  9836. The keyword TO is optional.
  9837.  
  9838. The text saved is only the body text without headers or attachments.
  9839. Except for available disk space, there is no limit on the size of the
  9840. message text.  Line Feed characters will be included at the end of each
  9841. line in the message.
  9842.  
  9843. RESULT:  0      There is no current message
  9844.          1      The current message text has been saved.
  9845.  
  9846. ***
  9847.  
  9848. Syntax: SAVE TEXT [TO] CLIPBOARD
  9849.         SAVE TEXT [TO] CLIPBOARD n
  9850.  
  9851. The first form of this command will save the text body of the Current
  9852. Message to the clipboard unit that is currently active.  The second form
  9853. will allow you to save the text to the clipboard unit specified by n.
  9854.  
  9855. You can determine which clipboard is currently active by using the GETCLIP
  9856. UNIT command.
  9857.  
  9858. If you use the "n" parameter, the currently active clipboard unit will be
  9859. changed to n after the command is successfully executed (RESULT of 1).
  9860. The keyword TO is optional.
  9861.  
  9862. The text saved is only the body text without headers or attachments.
  9863. Except for available RAM space, there is no limit on the size of the
  9864. message text.  Line Feed characters will be included at the end of each
  9865. line in the message.
  9866.  
  9867. RESULT:  0      There is no current message
  9868.          1      The current message text has been saved to the clipboard.
  9869.  
  9870. ***
  9871.  
  9872. Syntax: SAVE "string of text" [TO] CLIPBOARD
  9873.         SAVE "string of text" [TO] CLIPBOARD n
  9874.  
  9875. The first form of this command will save the string of text passed as a
  9876. quoted string to the clipboard unit that is currently active.  The second
  9877. form will allow you to save the string to the clipboard unit specified by
  9878. n.
  9879.  
  9880. You can determine which clipboard is currently active by using the GETCLIP
  9881. UNIT command.
  9882.  
  9883. If you use the "n" parameter, the currently active clipboard unit will be
  9884. changed to n after the command is successfully executed (RESULT of 1).
  9885. The keyword TO is optional.
  9886.  
  9887. The keyword TO is optional.
  9888.  
  9889. The string saved must be quoted to allow for embedded spaces and special
  9890. characters.  As an example:
  9891.  
  9892.     SAVE '"This is a string of characters"' TO CLIPBOARD 3
  9893.  
  9894. will save the string "This is a string of characters" to clipboard number
  9895. 3.
  9896.  
  9897. The string is limited to 119 characters. If a larger string is given it
  9898. will be truncated at 119 characters.
  9899.  
  9900. RESULT:  1      The string has been saved to the clipboard.
  9901.  
  9902.                                SCREENTOBACK
  9903.  
  9904. Syntax: SCREENTOBACK AEMAIL
  9905.         SCREENTOBACK WORKBENCH
  9906.         SCREENTOBACK public-screen-name
  9907.  
  9908. This command brings either the AEMail screen, the Workbench screen or
  9909. the named public-screen-name to the back of the display.
  9910.  
  9911. RESULT: 0   The public-screen-name is invalid or no longer open
  9912.         1   The specified screen has been moved to the back.
  9913.  
  9914.  
  9915.                               SCREENTOFRONT
  9916.  
  9917. Syntax: SCREENTOFRONT AEMAIL
  9918.         SCREENTOFRONT WORKBENCH
  9919.         SCREENTOFRONT public-screen-name
  9920.  
  9921. This command brings either the AEMail screen, the Workbench screen or
  9922. the named public-screen-name to the front of the display.
  9923.  
  9924. RESULT: 0   The public-screen-name is invalid or no longer open
  9925.         1   The specified screen is now the front most screen.
  9926.  
  9927.  
  9928.                                  SUBJECT
  9929.  
  9930. Syntax: SUBJECT
  9931.  
  9932. This command returns the Subject:  header of the current message without
  9933. "Subject: ".  It has no operands.
  9934.  
  9935. Also, the RE: and (fwd), if present, is stripped from the header string.
  9936. You can use the FLAGS command to determine if the current message is a
  9937. reply or forwarded message.
  9938.  
  9939. RESULT: -1              No current message
  9940.         NULL or blanks  No Subject: header
  9941.         Subject: header
  9942.  
  9943.  
  9944.                                     TO
  9945.  
  9946. Syntax: TO
  9947.  
  9948. This command returns the To:  header of the current message without the
  9949. "To: ".  It has no operands.
  9950.  
  9951. RESULT: -1              No current message
  9952.         NULL or blanks  No To: header
  9953.         To: header
  9954.  
  9955.                               Error Messages
  9956.                               --------------
  9957.  
  9958. When a command returns an RC value other than 0 the RC code represents a
  9959. severity code.  Severity codes are usually 5 or 20.  A string error
  9960. message will also appear in the AEMAIL.LASTERROR variable.  These errors
  9961. can be interrogated and displayed.
  9962.  
  9963. The errors that you can expect from AEMail are as follows:
  9964.  
  9965.         "100: Unknown command"
  9966.         "101: Syntax Error"
  9967.         "102: No Operand Required"
  9968.         "103: Missing Operand"
  9969.         "104: Too Many Operands"
  9970.         "105: Error Opening Passed Message"
  9971.         "106: Error retrieving passed message"
  9972.         "110: Out of Memory"
  9973.  
  9974. Additional errors which will not have a error message number associated
  9975. with them are:
  9976.  
  9977.         "Unable to open input mail file"
  9978.         "Error reading input mail file"
  9979.         "Unable to open output file"
  9980.         "Error writing to output file"
  9981.  
  9982.                              X. AEMAIL FILES
  9983.  
  9984. The following are the various files used by AEMail.  Normally, they all
  9985. reside in the user's mail directory with the exception of the
  9986. configuration file and the TCPLOG file.  The configuration file for the
  9987. primary user of AEMail normally is called aemail.cnfg and resides in the
  9988. S:  directory although it can be named differently or reside anywhere.
  9989. Other user's configuration files must be called something different and
  9990. may also reside anywhere.  TCPLOG file may reside in any directory
  9991. depending on the user's preference.
  9992.  
  9993. The mail directory is the directory given in the MAIL_DIR= Tool Type and
  9994. you can change the name and location of the aemail.cnfg file with the
  9995. CONFIG= Tool Type.
  9996.  
  9997. With the exception of the mailcap file, you can begin AEMail without any
  9998. of the other files being present.  They will be automatically created as
  9999. you process messages or do other AEMail actions.
  10000.  
  10001. The mailcap file, if used can be setup prior to executing AEMail or it can
  10002. be created or modified using the Viewer Page of the Configuration Setup.
  10003. If the mailcap file is setup outside the AEMail environment it can be done
  10004. using any text editor.
  10005.  
  10006. The following are the AEMail files:
  10007.  
  10008.                                  mailcap
  10009.                                  -------
  10010.  
  10011. The mailcap file is used to establish programs that should be executed to
  10012. display MIME attachments.  Use of this file allows AEMail to use any
  10013. AmigaDOS operating system 2.1 or above.
  10014.  
  10015. The mailcap file is a standard Internet file which is specified in RFC
  10016. (Request For Comment) 1524.  Since it is standard, you can use a mailcap
  10017. file that was created for another program that specified a display program
  10018. for the same media type.  If you use a mailcap file created outside the
  10019. AEMail environment it can be copied to the mail directory when AEMail is
  10020. installed if you use the expert level of the Install.
  10021.  
  10022. AEMail only uses the two required fields of the RFC 1524 standard.  Other
  10023. fields are ignored at this time.
  10024.  
  10025. Each mailcap file consists of entries that describe the proper handling of
  10026. one media type at the local site.  A mailcap file consists of a sequence
  10027. of such individual entries separated by LINE FEEDS.  Blank lines and lines
  10028. starting with '#' are considered comments and are ignored.  Long entries
  10029. may be continued on multiple lines if the line to be continued ends with a
  10030. backslash character ('\').  In this event, mutiple lines are to treated as
  10031. a single mailcap entry.  Note that for such "continued" lines, the
  10032. backslash must be the last character of the line to be continued.
  10033.  
  10034. Each mailcap entry consists of a number of fields each separated by a
  10035. semicolon (';').  The first two fields are required, and must occur in the
  10036. specified order.  The remaining fields are optional and may appear in any
  10037. order.  NOTE:  At this time AEMail does not use these optional fields and
  10038. if they are present, ignores them.  Because of this, these optional fields
  10039. WILL NOT be discussed in this documentation.
  10040.  
  10041. The general format of a mailcap entry is:
  10042.  
  10043.     content type; view command [; ......] LINE FEED
  10044.  
  10045. The first field is the content type, which indicates the type of data this
  10046. mailcap entry describes how to handle.  It is to be matched against the
  10047. type/subtype specification in the "Content-Type" MIME header (see the ADD
  10048. ATTACHMENTS REQUESTER described in section VIII.  AEMAIL WINDOWS above).
  10049.  
  10050. If the subtype is "*", it is intended to match all subtypes of the named
  10051. content type.
  10052.  
  10053. Examples of the content type field are:
  10054.  
  10055.     images/gif
  10056.  
  10057. which is intended to match only the images/gif type/subtype whereas
  10058.  
  10059.     images/*
  10060.  
  10061. matches all image types (images/gif, images/jpeg, etc).
  10062.  
  10063. The second field, view command, is a specification of how the attachment
  10064. meeting the content type specification is viewed.  For any particular
  10065. operating system, this would indicate how the program is called.  For
  10066. AEMail this would include the entire path name for calling the program and
  10067. any parameters that are needed on the command line.  A "%s" is used to
  10068. indicate the substitution of the attachment name.  The entire entry should
  10069. be surrounded by quotes.  As an example:
  10070.  
  10071.     "sys:Utilities/multiview %s screen"
  10072.  
  10073. would call multiview placing the displayed attachment on its own screen
  10074. (the "screen" parameter).
  10075.  
  10076. If you needed to have the display on the Workbench screen you can add the
  10077. keyword "wb;" in front of the program path.  As an example, if you wanted
  10078. multiview to open on a window on the Workbench screen, you could use:
  10079.  
  10080.     "wb;sys:Utilities/multiview %s"
  10081.  
  10082. Note the use of the quotes (") surrounding the parameter.  This is
  10083. necessary so that the mailcap interpreter will be prevented from treating
  10084. special characters (such as ';') as part of the mailcap syntax.
  10085.  
  10086. Also note the absence of the "screen" keyword.  The above call would push
  10087. the Workbench screen to the front when MultiView was called and the
  10088. Workbench screen would be used for the MultiView window.  The only problem
  10089. with this is you would be limited to the number of colors and the
  10090. resolution specified for Workbench.  Some other programs, however, might
  10091. only be able to open as a window on the Workbench screen and would be
  10092. hidden by the AEMail screen when those programs were called unless the
  10093. "wb;" parameter was specified.
  10094.  
  10095. An example of a complete mailcap entry to use multiview to display all
  10096. images would be:
  10097.  
  10098.     image/*; "sys:Utilities/multiview %s screen"
  10099.  
  10100. Any image/ type, regardless of the subtype, would be displayed providing
  10101. there was an appropriate data type present for that image subtype.
  10102.  
  10103. A sample mailcap file is included with the archive which uses MultiView
  10104. for text, message, sound, image, and video files.  Since MultiView is a
  10105. 3.x program using datatypes, this mailcap file will ONLY work with 3.x
  10106. systems.  To make it work for 2.x systems, you would need to change the
  10107. display programs to your favorite programs that work with 2.x.  You might
  10108. also have to be specific as to the subtype for a specific display
  10109. type/subtype.  If you install AEMail on a 2.1 system using the provided
  10110. installation script, you will be able to create the mailcap file provided
  10111. you selected "Expert" mode for the installation "user mode".
  10112.  
  10113. The following is the sample mailcap file used for AmigaDos 3.x that uses
  10114. MultiView as the display agent.  Please note the use of the "screen"
  10115. parameter which tells MultiView to open on it's own screen rather than the
  10116. WorkBench screen.  This allows the use of all colors in the image's
  10117. palette.
  10118.  
  10119.     text/*;  "sys:Utilities/multiview %s"
  10120.     message/*; "sys:Utilities/Multiview %s"
  10121.     image/*; "sys:Utilities/multiview %s screen"
  10122.     audio/*; "sys:Utilities/multiview %s screen"
  10123.     video/*; "sys:Utilities/multiview %s screen"
  10124.  
  10125.  
  10126.                  General Configuration File (aemail.cnfg)
  10127.                  ----------------------------------------
  10128.  
  10129. The s:aemail.cnfg file is the General Configuration file for your primary
  10130. user.  This file contains various configuration information including the
  10131. version and revision number of the AEMail version that was last loaded.  A
  10132. special flag in this file indicates whether this file should take
  10133. precedence over the Tool Type entries.
  10134.  
  10135. You do not have to store this file in the S:  directory nor do you have to
  10136. name it "aemail.cnfg".  This is only the default name and location for
  10137. this file.  With the use of the CONFIG= Tool Type or the config= parameter
  10138. on the shell call for AEMail, you can rename the file and place it
  10139. anywhere you want.
  10140.  
  10141. Starting with AEMail version 1.13 you can also have multiple configuration
  10142. files.  This allows you to set up multiple configurations for different
  10143. users of AEMail.  You can select which configuration you want through the
  10144. "Project/Configuration/Open" menu item or by executing an AEMail user's
  10145. Project icon.  If you use the "Project/Configuration/Open" menu to bring
  10146. in a different user's configuration file, that user must have the same
  10147. mail directory as the previous user.
  10148.  
  10149. If the configuration is never changed with the Configuration Setup, the
  10150. Tool Type entries will take precedence.  If either the [SAVE] or [SAVE TO]
  10151. gadgets in the Configuration Setup Window is selected, or the
  10152. "Project/Configuration/Save" or "Project/Configuration/Save to" menu items
  10153. are selected, the General Configuration File will always take precedence.
  10154.  
  10155. The s:aemail.cnfg (or CONFIG= Tool Type or config= shell parameter) is
  10156. referred as your base configuration file.  You can always return to the
  10157. base configuration through the "Project/Configuration/Restore Default"
  10158. menu item.
  10159.  
  10160. If you display the AEMail General Configuration file with a text editor,
  10161. you will find that not all portions of the file are readable as text.  The
  10162. only way you can create and update the general configuration file is
  10163. through AEMail itself.
  10164.  
  10165. As part of this file is your password stored in encrypted format.
  10166.  
  10167.  
  10168.                                  .headers
  10169.                                  --------
  10170.  
  10171. The .headers file provides a list of message headers.  Those that you want
  10172. displayed in the message as "minimum headers" are preceded by an asterick
  10173. (*); all other headers are preceded by a space.
  10174.  
  10175. The .headers file may not be present.  If it is not, the following are
  10176. displayed as the "minimum headers":
  10177.  
  10178.     Date:
  10179.     From:
  10180.     Reply-To:
  10181.     To:
  10182.     cc:
  10183.     bcc:
  10184.     Subject:
  10185.  
  10186. See the discussion on configuring minimum headers in the General
  10187. Parameters page of the Configuration Setup Window.
  10188.  
  10189.  
  10190.                               folder.config
  10191.                               -------------
  10192.  
  10193. This file gives the general information about each of the folders
  10194. including:
  10195.  
  10196.     Flags (long word, 4 bytes): general flags concerning this folder
  10197.     Name (9 bytes including ending NULL): short folder name
  10198.     Pen (1 byte): pen number for folder tab
  10199.     Sort Keys (8 bytes): the permanent sort keys for the folder
  10200.     Folder Description (string ending in LINE FEED): the folder
  10201.         description.  If this is a folder for one of the pre-set
  10202.         folders, this string will be empty (LINE FEED only) unless
  10203.         the user has decided to change the folder description.
  10204.     Each Filter string ending in a LINE FEED.  Each string begins with 4
  10205.         bytes that provide filter parameters as follows:
  10206.             1 byte indicating the header to be searched
  10207.             2 bytes of flags
  10208.             1 byte indicating the compare criteria
  10209.     Three successive LINE FEEDS ends each folder config entry.
  10210.  
  10211. For those fields that are strings:  if the field is empty there will be a
  10212. LINE FEED with no data preceding it.  If filters have been specified, each
  10213. filter will have at least 4 bytes followed by the search arguement (if
  10214. present) and a LINE FEED.
  10215.  
  10216. folder.config files for versions prior to 1.40 can be read by AEMail
  10217. version 1.40 or later.  However, once a filter has been added, earlier
  10218. versions can not properly read the version 1.40 or later folder.config.
  10219. If no filters are added, earlier versions of AEMail can still read the
  10220. folder.config file.
  10221.  
  10222. It is suggested that you copy your current folder.config file to
  10223. folder.config.old before implementing AEMail 1.40.
  10224.  
  10225. NOTE:  if for some reason your folder.config file becomes corrupted or is
  10226. accidently deleted, you can restore all of the folders and the messages
  10227. within them by doing the following:
  10228.  
  10229.     delete any current folder.config file (or rename it so it is
  10230.         no longer recognized).
  10231.     Run AEMail.  Add any additional folders that you previously
  10232.         had added.  (INBOX, PENDING, QUEUED and SENT will automatically
  10233.         be created).  You must use the exact name you had previously
  10234.         used.
  10235.     The new folders will show 0 messages.
  10236.     Quit AEMail.
  10237.     Re-Run AEMail.  The new folders should now show the appropriate
  10238.         number of messages provided a valid [folder_Name].config
  10239.         file was present for that folder.  The name of the new
  10240.         folder must exactly match the [folder_Name] in the
  10241.         [folder_Name].config file.
  10242.  
  10243.  
  10244.                            [folder_Name].config
  10245.                            --------------------
  10246.  
  10247. For each of the folders that contain messages there will be a
  10248. configuration file which gives information on the messages in that folder.
  10249. The name of the file will be the short folder name with ".config" appended
  10250. to it.
  10251.  
  10252. For this version of AEMail, the [folder_Name].config file contains the
  10253. following information for each message in the folder:
  10254.  
  10255.     Message Flags (word, 2 bytes): Flags describing the message.
  10256.     File Code (long word, 4 bytes): this field is a binary field
  10257.         which is used to derive the file name for the message file
  10258.         itself.
  10259.     Message Size (long word, 4 bytes): size of message.
  10260.     Body Displacement (word, 2 bytes): the position where the
  10261.         body of the message starts.
  10262.     From (string ending in LINE FEED): the information in the
  10263.         From: field in the message header.
  10264.     Subject (string ending in LINE FEED): the information in the
  10265.         Subject: field in the message header.  The RE: and FWD:
  10266.         headings at the beginning of the Subject header are
  10267.         stripped, but indicated by flags in the Message Flags field
  10268.         so that the exact subject field can be reconstructed.
  10269.     Date (string ending in LINE FEED): the information in the
  10270.         Date: field in the message header.
  10271.     To (string ending in LINE FEED): the information in the
  10272.         To: field in the message header.
  10273.     Reply-To (string ending in LINE FEED): the information in the
  10274.         Reply-To: field in the message header.
  10275.     cc (string ending in LINE FEED): the information in the
  10276.         cc: field in the message header.
  10277.     bcc (string ending in LINE FEED): the information in the
  10278.         bcc: field in the message header.
  10279.  
  10280. For those fields that are strings:  if the field is empty, there will be a
  10281. LINE FEED without any data preceding it.
  10282.  
  10283. NOTE:  For AEMail versions prior to 1.42, only the first header line of
  10284. any particular header type (ie, To:, cc:, etc.) was saved in the header
  10285. strings of the [Folder_Name].config file.  For version 1.42 and later, the
  10286. complete header string is saved with all lines of the particular header
  10287. type.  Up to 4096 characters can be saved (if there are that many lines
  10288. for a particular header type).
  10289.  
  10290. This is particularly important for messages that have multiple To: or cc:
  10291. recipients.  This means that the complete list of recipients can be
  10292. examined in Filter commands and also provides the capability to send
  10293. replys to all the recipients of a message.
  10294.  
  10295. This does create a problem, however, if the [Folder_Name].config created
  10296. by Version 1.42 or later is read by a version of AEMail prior to 1.42.
  10297. The Version 1.42 or later [Folder_Name].config file that contains any
  10298. message that has long multiple recipient lists (more than one line) can
  10299. not be read correctly by versions prior to 1.42.  If you need to revert to
  10300. an earlier version of AEMail, you can do the following:
  10301.  
  10302. With Version 1.42 or later, export (save) all messages with multiple
  10303. recipients that were read by 1.42 or later to a file.  You do not have to
  10304. worry about messages read by earlier versions.
  10305.  
  10306. Delete all of the messages you just saved.
  10307.  
  10308. Then, from the earlier version of AEMail, retrieve from file the messages
  10309. you just saved.  The header lines will be truncated by the earlier
  10310. version.
  10311.  
  10312. The reverse is also possible.  Messages with multiple recipients read by
  10313. earlier versions will have their header data truncated.  You can export
  10314. (save) the message to a file and then re-read it into AEMail with all
  10315. header data intact.
  10316.  
  10317.  
  10318.                                 .addrbook
  10319.                                 ---------
  10320.  
  10321. This file provides address book information.  Each record looks like this:
  10322.  
  10323.     Version (word, 2 bytes): The address book version.  Prior to
  10324.         Version 1 of the address book, this and the following field
  10325.         did not exist.  The flag $8000 identifies this as a
  10326.         legitimate version field to distinguish the addess book
  10327.         file from version 0.  NOTE: The Address Book version is
  10328.         NOT the same as the AEMail Version.  The Address Book
  10329.         version only changes when the format of the Address Book
  10330.         changes.
  10331.     Flags (word, 2 bytes): Flags describing group actions.  In
  10332.         Version 0, the flags field was given in the high order byte
  10333.         of the count field which limited the group count to 255.
  10334.     Count (word, 2 bytes): If this field is zero, the entry is
  10335.         a single user entry.  If this field is greater that zero
  10336.         it represents a group entry and indicates the number of
  10337.         UserIds in the group.
  10338.     Nickname (string ending in LINE FEED): the Nickname for this
  10339.         entry (both group or user).
  10340.     Real Name (string ending in LINE FEED): the Real Name for
  10341.         individual users or the group description for group
  10342.         entries.
  10343.     UserID (one or more strings ending in LINE FEEDS):  The number
  10344.         of UserID fields is determined by the count at the
  10345.         beginning of the record.  For individual users, this MUST
  10346.         be the UserID and Domain for that user.  For group users
  10347.         this can be a Nickname that points to the real user.
  10348.  
  10349. For a description of how entries in the Address Book can be created and
  10350. displayed see the Section VIII, AEMAIL Windows:  Address Book window.
  10351.  
  10352.  
  10353.                                 .signature
  10354.                                 ----------
  10355.  
  10356. This is a flat ASCII file that contains the signature block that is to be
  10357. appended to any composed messages.  Each line of the signature block must
  10358. end in a LINE FEED.
  10359.  
  10360. A facility is provided when composing messages to create and or edit this
  10361. signature block (see the Compose Message window description in Section
  10362. VIII above).
  10363.  
  10364. Starting with AEMail Version 1.20, multiple signature files can be used.
  10365. These signature files can be named whatever the user wishes and can be
  10366. placed wherever the user wishes (Registered Users ONLY).
  10367.  
  10368.                                  Messages
  10369.                                  --------
  10370.  
  10371. Each message is stored as an individual file with a cryptic file name
  10372. generated from the File Code in the [Folder_Name].config file.  This name
  10373. begins with "AE" and ends with "M" with a number of numeric digits in
  10374. between.  The message is stored as a flat ASCII file as it is received
  10375. from the POP Server with any CARRAGE RETURNS in a CARRAGE RETURN/LINE FEED
  10376. sequences stripped.  This follows the Amiga format for ASCII files.
  10377.  
  10378. The complete message is stored along with any attachments as they were
  10379. orginally received.  Any particular message can be copied to a named file
  10380. anywhere in your system through the "SAVE MESSAGE TO FILE" command.  If
  10381. you have an off line program that can process a mime message or a message
  10382. with UUENCODED attachments, you can use that program against this file to
  10383. extract the attachments or you can save that attachment directly with the
  10384. Attachment Requester in the Message Display Window (Section VIII).
  10385.  
  10386. If messages are left in the PENDING or QUEUED folders, two additional
  10387. files may be created when AEMail terminates.  If attachments were added to
  10388. the message when it was created, a file with the same name as the message
  10389. file but with "AT" appended to it will be created.  This file contains
  10390. information about the attachments.  A second file may be created if
  10391. additional headers were created.  This file has "HD" appended to the
  10392. original message name.
  10393.  
  10394. Both of these files are deleted when AEMail is loaded and the PENDING and
  10395. QUEUED message lists are created internally.  The files are re-created if
  10396. the messages remain in the PENDING or QUEUED folders when AEMail
  10397. terminates normally.
  10398.  
  10399. PLEASE NOTE:  if the [folder_Name].config file is deleted you will lose
  10400. all capability of retrieving your messages unless you have previously
  10401. copied them to named files.
  10402.  
  10403.  
  10404.                        TCP Trace Log File (TCPLOG)
  10405.                        ---------------------------
  10406.  
  10407. This file is present if you have specified
  10408.  
  10409.     TCPLOG=name-of-log-file
  10410.  
  10411. in the Tool Types parameters or named a "TCP Logging File" in the Default
  10412. Path Parameters page of the Configuration Setup Window.  Since
  10413. "name-of-log-file" should be the full path name of the log file, this file
  10414. may reside in any directory.  If there is no path name, the log file will
  10415. reside in you AEMail program directory.
  10416.  
  10417. The TCP Trace Log File traces every TCP transaction.  Each time AEMail is
  10418. started the following record is written to the file:
  10419.  
  10420.     Logging Beginning at DD MMM YR HH:MM:SS
  10421.  
  10422. where DD is the day of the week, MMM is the month (Jan, Feb, Mar, etc), YY
  10423. is the 2 digit year (97) and HH, MM, and SS are the hour (24 hour clock),
  10424. minutes, and seconds.
  10425.  
  10426. Each logging record will consist of a 38 byte header and up to 82 bytes of
  10427. either descriptive information or actual data received or sent over the
  10428. TCP interface.  The header consists of a 21 byte date/time stamp (DD MMM
  10429. YR HH:MM:SS) and 16 byte routine name of the routine in AEMail that called
  10430. the trace.
  10431.  
  10432. If data is displayed, instances of a CARRAGE RETURN will be displayed as
  10433. <CR> and of LINE FEEDS as <LF>.  If the data exceeds 82 bytes, <---> will
  10434. be placed at the end of the line.
  10435.  
  10436. When AEMail terminates, or the TCPLOG file name is changed by the 
  10437. Default Path Parameters page of the Configuration Setup, the following
  10438. record is written to the file:
  10439.  
  10440.     Logging Ending at DD MMM YY HH:MM:SS
  10441.  
  10442. Each AEMail session is stacked behind the previous one, so that the file
  10443. can become quite large.  Periodic purging of the file can occur by
  10444. deleting the TCPLOG file in between sessions of AEMail.  Also, a new file
  10445. is created when you change the name of the TCPLOG file with the
  10446. Configuration Setup.
  10447.  
  10448.  
  10449.                      XI. BUG REPORTS AND SUGGESTIONS
  10450.  
  10451. Bugs should be reported to:
  10452.  
  10453.     jzachar@calweb.com
  10454.  
  10455. by email.  You can also use the nickname AEMAIL which has been
  10456. automatically stored in your address book.
  10457.  
  10458. In reporting bugs, be as complete as possible in describing the
  10459. circumstances leading up to the bug.  It would be helpful if you indicate
  10460. all actions (mouse clicks, etc) that you took before the problem occurred.
  10461. If you are having problems connecting to your Internet provider, or
  10462. sending or receiving mail, you should activate the TCP Log file (See
  10463. Section X, AEMAIL FILES:  TCP Trace Log File) and send a copy of the log
  10464. as an attachment to your message.  You might want to block out any
  10465. password that is contained in the file before you send it to me, however.
  10466. You can do that with any text editor.
  10467.  
  10468. I would also appreciate any suggestions that you have for improving
  10469. AEMail.  I will not guarantee that I will accept all suggestions or that I
  10470. will necessarily implement them in the next release; however, I do take
  10471. each suggestion seriously.  In the past I have implemented a number of
  10472. suggestions made by my testers.  I will attempt to respond to each
  10473. suggestion that is made.
  10474.  
  10475. In making suggestions keep in mind some of the restraints that I have
  10476. placed on AEMail:
  10477.  
  10478.     (1) The program should be able to be run on any version of
  10479.         AmigaDos 2.1 or greater, and
  10480.  
  10481.     (2) with the exception of TCP/IP stack software (the standard Amiga
  10482.         does not come with such software which is required for Internet
  10483.         access) or ClassAct, AEMail should not require any extension to
  10484.         your system that does not come with a standard AmigaDOS release.
  10485.         This effectively rules out MUI although ClassAct is an alternative
  10486.         to MUI.
  10487.  
  10488.         ClassAct utilizes Boopsi Classes which have been an integral part
  10489.         of the Amiga OS since version 2.  ClassAct also allows
  10490.         capabilities in AmigaDos 2.1 that the standard gadtools interface
  10491.         does not.  The ClassAct classes AEMail requires are provided as a
  10492.         part of the AEMail release which means that the user does not have
  10493.         to provide anything additional.
  10494.  
  10495.         Using an editor of your choice also meets this criteria since you
  10496.         can use the standard AmigaDOS editors, ED or MEMACS, which come
  10497.         with the standard Amiga systems.
  10498.  
  10499. When reporting bugs or making suggestions, please be as complete as
  10500. possible in describing the circumstances that brought about the problem or
  10501. how the suggestion could be implemented.
  10502.  
  10503.  
  10504.                              XII. REFERENCES
  10505.  
  10506. A number of software packages are mentioned in this documentation.
  10507. Details on how to obtain these packages are given below:
  10508.  
  10509.     TCP/IP STACKS
  10510.  
  10511.         AmiTCP      A TCP/IP stack for use with the Amiga.  AmiTCP
  10512.                     is copyright (c) 1994, 1995 by Network Solutions
  10513.                     Development, Inc.
  10514.  
  10515.                     AmiTCP was developed by Network Solutions Development,
  10516.                     Inc., P.O.  Box 32, FIN-02151 Espoo, Finland.
  10517.  
  10518.                     A demo 4.0 version is available on AmiNet sites in
  10519.                     countries other than USA or Australia.  It can also
  10520.                     be found on many BBS's.
  10521.  
  10522.                     The commercial version is distributed by Village
  10523.                     Tronic Marketing GmbH, Wellweg 95, D-31157 Sarstedt,
  10524.                     Germany, and is available from many Amiga dealers and
  10525.                     mail order houses.
  10526.  
  10527.                     World Wide Web home page for Network Solutions
  10528.                     Development, Inc is:
  10529.  
  10530.                         http://www.xgu.fi/biz/NSDI/
  10531.  
  10532.                     email addresses: info@nsdi.fi
  10533.                                      AmiTCP-Support@nsdi.fi
  10534.                                      AmiTCP-Group@nsdi.fi
  10535.  
  10536.         Miami       A TCP/IP stack compatible with AmiTCP.  This stack
  10537.                     is very simple to install and configure.  Miami is
  10538.                     copyright (c) 1996, 1997 by Holger Kruse.  It is
  10539.                     currently shareware and is available at
  10540.  
  10541.                         http://www.nordicglobal.com/miami.html
  10542.  
  10543.                     on the WWW or it may be available on local BBS's.
  10544.                     Some versions are available on AmiNet, but if you want
  10545.                     the latest version consult the web page listed above.
  10546.  
  10547.                     email addresses: kruse@nordicglobal.com
  10548.                                      kruse@america.com
  10549.  
  10550.                     If you are using Miami, the "Down when Offline" item
  10551.                     in the TCP/IP Settings page for Miami should be
  10552.                     checked and your settings saved.  This will prevent
  10553.                     Miami from waiting 80 seconds before returning a
  10554.                     failure when you try to access the Internet when you
  10555.                     are "Offline".
  10556.  
  10557.         TermiteTCP  A TCP/IP stack compatible with AmiTCP.  This stack is
  10558.                     very simple to install and configure.  TermiteTCP is
  10559.                     copyright (c) 1996 by Oregon Research, 16200 S.W.
  10560.                     Pacific Hwy, Suite 162, Tigard, OR 97224.
  10561.  
  10562.                     This is a commercial product available at many Amiga
  10563.                     dealers, mail order houses, or directly from Oregon
  10564.                     Research.
  10565.  
  10566.                     World Wide Web home page for Oregon Research is:
  10567.  
  10568.                         http://www.orres.com/~orres/
  10569.  
  10570.                     email address: support@orres.com
  10571.  
  10572.  
  10573.     WEB BROWSERS
  10574.  
  10575.         IBrowse     Copyright (c) 1995, 1996 by Omnipresence Intl.
  10576.  
  10577.                     IBrowse is a commercial product distributed by Oregon
  10578.                     Research in the United States and HiSoft in the
  10579.                     United Kingdom and can be obtained from Amiga dealers
  10580.                     or mail order houses.  A demo version and upgrades can
  10581.                     be obtained from the Omnipresence web site at:
  10582.  
  10583.                         http://www.omnipresence.com/ibrowse
  10584.  
  10585.                     and on AmiNet.
  10586.  
  10587.         Voyager NG  Copyright (c) 1995-97 by Oiver Wagner.  Voyager is
  10588.                     available for download from AmiNet or the
  10589.  
  10590.                         http://www.vapor.com/support
  10591.  
  10592.                     web site.
  10593.  
  10594.                     email address: owagner@lsd.wupper.de
  10595.  
  10596.         AWeb-II     Copyright (c) 1996 by AmiTrix Development.
  10597.  
  10598.                     Both a public domain demo (AWEB) and a commercial
  10599.                     (AWEB II) version is available.  The public domain
  10600.                     demo version can be found on AmiNet (AWeb v1.2b),
  10601.                     many BBS's, or on the AmiTrix web site:
  10602.  
  10603.                         http://www.networkx.com/amitrix/aweb.html
  10604.  
  10605.                     The commercial version (AWEB II) can be obtained from
  10606.                     Amiga dealers or mail order houses.
  10607.  
  10608.                     email addresses: sales@amitrix.com
  10609.                                      support@amitrix.com
  10610.  
  10611.                     Mailing address: AmiTrix Development
  10612.                                      5312-47 Street
  10613.                                      Beaumont Alberta, Canada T4X 1H9
  10614.  
  10615.  
  10616.                            XIII. IN CONCLUSION
  10617.  
  10618. As payment for receiving and using the unregestered version of AEMail, I
  10619. would like any bugs, comments, or suggestions reported to me.  You can
  10620. send me email at
  10621.  
  10622.     jzachar@calweb.com
  10623.  
  10624. or use the AEMAIL Nickname created in your Address Book.
  10625.  
  10626. You can also register AEMail for a shareware fee of $30.  See the
  10627. discussion on REGISTRATION under Section II.  SYSTEM REQUIREMENTS.
  10628.  
  10629. See the Section X, Bug Reports and Suggestions above for the reporting
  10630. procedure.
  10631.  
  10632. If you give an unregistered version of this program to anyone else to use
  10633. and evaluate, please include the complete archive as distributed.  This
  10634. includes the AEMail program, the installation script, and all
  10635. documentation and readme files.  DO NOT GIVE A REGISTERED VERSION OF
  10636. AEMAIL TO ANYONE!
  10637.  
  10638. The complete, unregistered archive may be posted to any BBS.  If it is
  10639. posted to any particular BBS, I would appreciate it if the person posting
  10640. it to the BBS would send me an email message indicating the BBS it was
  10641. posted to.
  10642.  
  10643. I have a web site at:
  10644.  
  10645.     http://www.calweb.com/~jzachar/
  10646.  
  10647. The latest version of AEMail will be posted to this web site.  Major
  10648. releases may also be posted on AmiNet.
  10649.  
  10650. Whenever a new version of AEMail is available, I will email all users of
  10651. AEMail version 2.00 and above for which I have received notification
  10652. messages (see Notification Requester in Section II) with a notice of the
  10653. new version.  Users of AEMail prior to Version 2.00 who are not registered
  10654. users and who have not upgraded will no longer receive this notice.  To
  10655. receive these notices it is important that you send the notification
  10656. message when you upgrade.
  10657.  
  10658. Thanks,
  10659.  
  10660. John Zacharias
  10661. jzachar@calweb.com
  10662.  
  10663. www: http://www.calweb.com/~jzachar/
  10664.  
  10665.  
  10666.